# 获取API接口 accessToken
# 接口描述
令牌（accessToken）用于访问平台接口时做权限鉴定。令牌生成后有效期为 7200 秒，请自行做好令牌的管理。
在令牌未过期时，重新调用接口获取新的令牌，旧的令牌不会立刻失效，会在 300 秒后失效（此时新旧令牌都可以使用）。
请注意：同一时间最多只能存在两个可用的令牌。
# accessToken 使用说明
除非接口有特殊说明，否则请求平台所有接口均需在 Header 中携带 accessToken 参数。
accessToken: leyJhbGciOiJIUzI1NiJ9.eyJhcHBrZXkiOiIwLXh5eGoiLCJhY2Nlc3NUb2tlbklkIjoiYTNjM2ZlZmJjYWI1NGJmMmE4MDliYmQ3YjAxNjU0ZmEiLCJpYXQiOjE2NTY5NDI5MzEsImV4cCI6MTY1Njk1MDEzMX0.Ht65S_mt5wQLyOWEXE-42BVQVczckSD3flZnCQhm_wk
# 字符编码
UTF-8
# 请求地址
/openapi/token
# 请求方式
POST(application/json)
# 请求 Header 参数
无
此接口无需传递 accessToken
# 请求 Body 参数
| 参数名 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| appKey | String | 50 | 必填 | 平台提供的AppKey |
| appSecret | String | 100 | 必填 | 平台提供的AppSecret |
# 请求 Body 示例
{
"appKey": "4567890dfsf678",
"appSecret": "3foijeio929f02jf032jf2ff2309"
}
1
2
3
4
2
3
4
# 返回参数列表
| 参数名 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| code | Integer | - | 必填 | 返回码，详见返回码表 |
| msg | String | - | 否 | 信息描述 |
| data | AccessTokenVo | - | 否 | 返回数据 |
AccessTokenVo 结构
| 属性 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| accessToken | String | 512 | 是 | 请求具体 API 时作签名使用 |
| expire | number | 4 | 是 | 失效时间 |
# 返回参数示例
{
"code": 200,
"msg": "成功",
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJkYXRhIjp7ImFwcGtleSI6InRlc3QiLCJhY2Nlc3NfdG9rZW5faWQiOiI5MjI3ZDcwMWFlOTk0MGJiYjNiYjI2YzAxMWI1YjEzYiJ9LCJpYXQiOjE2NTY1NjYwMzYsImV4cCI6MTY1NjU3MzIzNn0.sBua8zQN8SRq6dTuj-SiGjVYo0rYWyjNDwynnisD5cg",
"expire": 7200
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 返回码表
| 返回码 | 说明 |
|---|---|
| 200 | 成功 |
| 500 | 失败 |
| 1600002 | 缺少必要的请求参数 |
| 1600003 | 服务调用错误 |
| 1601001 | 缺少 appKey 参数 |
| 1601002 | 缺少 appSecret 参数 |
| 1601005 | appKey 和 appSecret 不匹配 |
| 1601006 | 请求太频繁，请稍后访问 |
| 1601009 | IP未授权 |