获取令牌(access_token)
接口路径:
https://gateway-smart.shouqianba.com/api/platform/v1/access_token
限流
5 次/秒
说明
- 除获取令牌接口本身以外的其余各业务接口,开发者在调用各业务参数时,需要在请求参数中携带令牌,可以通过该接口来获取令牌。
- 令牌是后续业务接口调用的唯一有效凭证,请开发者妥善保存,避免泄露。
- 每次获取的令牌有 120 分钟有效期,开发者可以在快要到期前重新获取,重新获取不会立即导致旧的令牌失效,旧的令牌剩余过期时间如果超过 10 分钟,则会在 10 分钟后失效,如果不足 10 分钟,则继续按照原有失效时间失效。
- 为了安全起见,多次调用获取令牌时,开放平台只会存储最近 3 个有效的令牌,其余的令牌会立马失效
请求参数
| 字段 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| appId | String | 是 | sqbApp2023xxxx | 应用的 AppId |
| appSecret | String | 是 | abc123 | 应用的 AppSecret 密钥 |
返回参数
| 字段 | 类型 | 必须 | 示例值 | 说明 |
|---|---|---|---|---|
| accessToken | String | 是 | TVRKa05qUXhOV1l0T1dVMU5TMDBZVFU0 | 获取到的令牌字符串 |
| expireIn | Number | 是 | 1702276912510 | 令牌过期的 Unix 时间戳,目前为 2 小时 |
请求数据示例
入参
{
"appId": "sqbApp2023xxxx",
"appSecret": "abc123"
}
出参
{
"accessToken": "TVRKa05qUXhOV1l0T1dVMU5TMDBZVFU0=",
"expireIn": 1702276912510
}
错误码列表
| 错误码 | 含义 |
|---|---|
| 40002 | 无效的 AppId 或 AppSecret |