Skip to content

获取带看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)

注意:
  1. timestamp为请求时间的时间戳,单位为毫秒。允许与服务器接收到请求时间的误差为5分钟
  2. 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重复