获取鉴权Token

更新时间：2020-08-27 09:10:51

接口描述

该接口专门供OAuth2.0鉴权方式用，采用请求签名鉴权方式时无需调用此接口。

详见OAuth2.0鉴权方式调用接口说明

通过应用ID和应用密钥获取授权码Token，用来请求api接口。授权码Token有效时长为120分钟。

当授权码Token即将到期时需要调用接口重新获取授权码Token。旧授权码Token可以与新授权码Token共存5分钟，5分钟后旧授权码Token失效。

e签宝服务端允许开发者多次调用“获取鉴权Token”接口获取授权码Token。但只有最新获取的授权码Token的有效时长为120分钟。

举例：

连续获取100个授权码Token（T1，T2，……，T99，T100），此时T1-T98个Token属于失效Token无权调用接口。而T99个Token有效时长为5分钟，T100个Token有效时长为120分钟。

如果开发者同时有多台服务器调用api接口，建议使用集中存储方式保存授权码Token以确保授权码Token值的唯一。

接口

/v1/oauth2/access_token

请求方式

GET

请求参数

参数名称	类型	必选	参数类型	参数说明	示例值
appId	string	是	query	应用id，需在e签宝开放平台创建	1111563841
secret	string	是	query	应用密钥，不可泄露	753b9f6acafcbba300315838be337 4c1
grantType	string	是	query	授权类型，固定值: client_credentials	client_credentials

响应参数

展开全部参数参数名称		类型	必选	长度	参数说明	示例值
code		int	是		业务码，0表示成功
message		string	否		信息
data		object	否		业务信息
	token	string	否		授权码注意：120分钟失效，请在expiresIn参数的有效截止时间失效前重新获取token
	expiresIn	string	否		有效截止时间（毫秒）
	refreshToken	string	否		刷新授权码

请求示例

GET 【请求地址】/v1/oauth2/access_token?appId=1111563841&secret=753b9f6acafcbba300315838be3374c1&grantType=client_credentials

Postman请求示例

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "expiresIn":"1569211376807",
        "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJnSWQiOiI4N2I4YmJhNGY2N2U0ZjRiODQ3Njc2M2FmNTRjZGYxYSIsImFwcElkIjoiNDQzODc3MTgwOSIsIm9JZCI6ImJiZDNlYTExZWY0ZDQyNmI4NTYzNDhmYjg1MDYxM2ZmIiwidGltZXN0YW1wIjoxNTY5MjA0MTc2ODA2fQ.tiXdZeKPNWFrbt-i3fJfe8YiSIeouEIyt9i8TdQ85-Q",
        "refreshToken":"64924e629bc5923172dec8fca019fba9"
    }
}

错误码

错误码	错误描述	解决方案
401	UNAUTHORIZED	apiurl和应用ID的环境不对应，例如apiurl是模拟环境，应用ID是正式环境的