获取令牌(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

results matching ""

    No results matching ""