简介

本文档主要针对HTTP API调用者,调用API时必须在URL中带上accesss_token参数,获取Access Token的流程如下:

获取Access Token

请求URL数据格式

向授权服务地址https://www.yxiaowei.com/Api/Oauth/getToken发送请求(使用POST),并在URL中带上以下参数:

  • grant_type: 必须参数,固定为client_credential;
  • appid: 必须参数,应用的appid;
  • secret: 必须参数,应用的app_secret;

例如:

https://www.yxiaowei.com/Api/Oauth/getToken?grant_type=client_credential&appid=201808081828&client_secret=0rDSjzQ20XUj5itV6WRtznPQSzr5pVw20rDSjzQ20XUj5itV6WRtznPQSzr5pVw2
获取access_token示例代码(以下为PHP示例代码)
<?php
function request_post($url = '', $param = '') {
        if (empty($url) || empty($param)) {
            return false;
        }

        $postUrl = $url;
        $curlPost = $param;
        $curl = curl_init();//初始化curl
        curl_setopt($curl, CURLOPT_URL,$postUrl);//抓取指定网页
        curl_setopt($curl, CURLOPT_HEADER, 0);//设置header
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);//要求结果为字符串且输出到屏幕上
        curl_setopt($curl, CURLOPT_POST, 1);//post提交方式
        curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
        $data = curl_exec($curl);//运行curl
        curl_close($curl);

        return $data;
    }

    $url = 'https://www.yxiaowei.com/Api/Oauth/getToken';
    $post_data['grant_type']       = 'client_credential';
    $post_data['appid']      = '你的 appid';
    $post_data['secret'] = '你的 app_secret';
    $o = "";
    foreach ( $post_data as $k => $v ) 
    {
        $o.= "$k=" . urlencode( $v ). "&" ;
    }
    $post_data = substr($o,0,-1);

    $res = request_post($url, $post_data);

    var_dump($res);

?>
说明: 鉴权使用的Access_token必须通过appid和app_secret获取。
服务器返回的JSON文本参数如下:

access_token: 要获取的Access Token; expires_in: Access Token的有效期(秒为单位,一般为1个月); 例如:

{
  "access_token": "24.6c5e1ff107f0e8bcef8c46d3424a0e78.2592000.1485516651.282335-8574074",
  "expires_in": 2592000
}
若请求错误,服务器将返回的JSON文本包含以下参数:
  • status: 错误码;关于错误码的详细信息请参考下方鉴权认证错误码。
  • msg: 错误描述信息,帮助理解和解决发生的错误。
    例如认证失败返回:
    {
      "status": "40001",
      "msg": "appid is invalid"
    }
    
    鉴权认证错误码
错误码 错误描述 备注说明
-1 Unknown error 服务器内部错误,请再次请求, 如果持续出现此类错误,请通过QQ群(872429018)或邮件(yuanwei@yxiaowei.com)联系袁小威。
0 success 数据请求成功
10000 missing parameters: {参数名} 重要参数缺失
40001 参数名 is invalid appid或app_secret不正确或不存在
40002 grant_type error grant_type参数不合法

results matching ""

    No results matching ""