简介

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

获取Access Token

请求URL数据格式

向授权服务地址https://www.yuanxiaowei.com/Api/Oauth/getToken发送请求（使用POST），并在URL中带上以下参数：

• grant_type： 必须参数，固定为client_credential；
• appid： 必须参数，应用的appid；
• secret： 必须参数，应用的app_secret；

例如：

https://www.yuanxiaowei.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.yuanxiaowei.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"
  }
  

  鉴权认证错误码