获取移动端SDK的token
接口说明:
此接口返回的token,仅用于完成移动端SDK功能
此token有效期默认为一天
重复获取该token时,不会刷新之前获取的token,即该token在有效期内一定有效
所以,接入方不需要缓存某次获取到的token,需要使用到时,请重新获取
请求路径:
{HostName}/api/v2/op/token/mobile/
请求方式:
- POST
入参示例
{
"app_id": "F2rdmn7pf5R",
"timestamp": "1629171831200",
"request_id": "877573639233609728",
"sign": "90da587dc342b6621e6d24fffc655b9f"
}
传入参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
app_id | string | 是 | app_id |
timestamp | string/int | 是 | 当前时间戳,单位为毫秒 |
request_id | string | 是 | 一个随机不重复的字符串,用于计算sign |
sign | string | 是 | 一段加密字符串,加密方式见下文 |
sign计算方法:
sign = MD5(app_id + app_secret + timestamp + request_id)
注意:
timestamp
为请求时间的时间戳,单位为毫秒。允许与服务器接收到请求时间的误差为5分钟request_id
为接入方随机生成的唯一字符串,短时间内多次请求时,接入方需要保证这个值不重复。即在短时间内使用重复的request_id
请求,众趣方会认定这是非法请求。
响应参数
{
"msg": "success",
"code": 1,
"data": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJuYmYiOjE2ODc2NzU3NDQsImlzcyI6IjNHdmo2TWN4a3VCY21rM0Q3YzFFOU1UQnBEcXltbVRlIiwiZXhwIjoxNjg3NzYyMTQ0LCJhcHBfaWQiOiJHa2tmczliU2kwUyIsImNfaWQiOjk4NiwidG9rZW5fdHlwZSI6Im1vYmlsZV9zZGsifQ.fs_cmE0ie7snY0DbWX5j9IMFLMqAfkxhTVD16vmlgb8",
"expire_in": 86400
},
"detail": null
}
响应参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
msg | string | 是 | 响应状态描述 |
code | int | 是 | 响应状态码 |
token | string | 是 | token |
expire_in | int | 是 | 有效时间,单位秒 |
detail | string | 否 | 描述 |
消息码code取值及说明:
code值 | 说明 |
---|---|
1 | 成功 |
31000 | 不支持当前请求的版本 |
33000 | 参数校验失败 |
33001 | 缺少必要的参数 |
32000 | 签名校验失败 |
32001 | request_id重复 |