# 换取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条评论
评论