获取带看token
接口id:
5
接口说明:
此接口返回的takelook_token,仅用于完成带看功能
takelook_token有效期默认为一天
重复获取takelook_token时,不会刷新之前获取的token,即takelook_token在有效期内一定有效
所以,接入方不需要缓存某次获取到的带看token,需要使用到时,请重新获取
请求路径:
{HostName}/api/v2/op/token/takelook/
请求方式:
- 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": "gAAAAABi6c-YnKdHXfyljVGheGyBlchIjZioEe9yZATM45pidHz4bP9iNmnHtQxTqUOtrj4JgDFXU4nzUYQ6rTzhcrndaxs4Nm4efiYPxNTdjanpSJxXN7OK-tC0CXO45LSGmKbomNCQNkVa9FAb2tLAQELeDJ8z5ATa4qXGhWGqaFBhPHNzP0CjFRoUho8LC1hQLXeyKrme",
"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重复 |