认证鉴权

我们提供了OAuth的授权登录方式，可以让API对接免去登录的环节。所有API均可通过OAuth2.0认证鉴权来获取完整的访问凭证（access_token）。OAuth2的设计背景，在于允许ISV通过授权方式，自动获取当前用户身份，进而调用此用户身份所有API资源。

获取access_token

根据获取到的AppKey和AppSecret，通过调用OAuth系列接口来获取access_token。

请求地址

POST /v2/public/oauth2/login  HTTP/1.1

Header头信息

Content-Type : application/json;charset=UTF-8

Body参数

Request Body 为 JSON 格式，说明如下。

参数名称	参数类型	说明
grant_type	String	固定client_credentials
client_appkey	Long	第一步获取的AppKey
client_secret	String	第一步获取的appsecret的md5值（应为32位小写）

示例参数

{
    "grant_type":"client_credentials",
    "client_appkey":"xxxxxx",
    "client_secret":"xxxxxxxxxxxxxxxxxxxx"
}

返回值

返回的结果为JSON格式，遵循公共报文格式，示例如下：

{
    "reqId": "0550e35a24014277ab056cf7246eb7db",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "access_token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJbLTEsLTEsLTEsMTAwLFwiXCIsMTAwMDIyODksbnVsbCxcIlwiLC0xLG51bGxdIiwiZXhwIjoxNjk2NTcwMzMxLCJpYXQiOjE2OTUyNzQzMzF9.8W4VCifcKbU7SG-7HzGn8I0wspGb96f6-chqVbYDDx-lG9pTaFlbGuHNRWZc7k6Hf-Ya7HtAzdqa8FgLVdht4g"
    }
}

刷新access_token

获取access_token时，expires_in字段返回过期时间（单位毫秒），在这个时间之后access_token将会失效。在失效前，请重新登录或调用刷新接口，获取新的access_token。

获取access_token#

刷新access_token#

获取access_token

刷新access_token