# 换取acccess_token
用于第三方应用后台根据code
获取acccess_token
。
code
是用户授权应用时传递给第三方应用的一个临时授权码,需要换取acccess_token
,并在后续调用相关API时传递acccess_token
以便获得访问权限。
开放授权应用、静默授权应用和IP授信应用都是通过此API换取acccess_token
。
# 调用说明
请求方式: POST
请求url:/api/oauth2/getToken
参数示例:
{
"appid": "5rc6t7vyb8u9nimpo",
"app_secret": "q3zw4xe5cr68vt79by80un9ie5r6ctv7yb8uio",
"code": "w4ex57cr6tv7by8unio",
"userid": "user1",
"grant_type": "code",
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
appid | 是 | 应用ID |
app_secret | 是 | 应用秘钥 |
code | 否 | 用户授权码,对于开放授权应用和静默授权应用需要这个参数,对于IP授信应用不需要 |
userid | 否 | 用户ID对于IP授信应用需要这个参数用于获取权限,开放授权应用和静默授权应用不需要 |
grant_type | 是 | 对于开放授权应用传递 code , 对静默授权应用传递auto ,对于IP授信应用传递ip |
特殊说明:对于IP授信应用,发起请求的服务器(或者代理服务器)的IP需要是应用配置中的IP。
# 返回值说明
示例:
{
"result": true
"errorCode": "appNotFound",
"message": "授信应用不存在",
"access_token": "er6ct7v8ybu9nimp",
"expired_in": 7200,
"refresh_token": "crft7gvyhbunimo[nibu9vy8tc7]"
}
参数说明:
参数 | 说明 |
---|---|
result | 结果是否有错误 |
errorCode | 错误码 |
message | 错误文本提示 |
access_token | 接口调用凭证 |
expired_in | access_token有效时间,单位为秒,默认为2小时 |
refresh_token | 用来刷新 access_token,对于IP授信应用不能刷新,没有这个返回值 |
errorCode
说明:
errorCode | 说明 |
---|---|
appNotFound | 授信应用不存在 |
secretMismatch | 应用秘钥错误 |
codeNotFound | 授权码过期 |
ipMismatch | IP不匹配 |
0条评论
评论