token获取接口
接口说明:
获取请求众趣开放平台业务接口需要的鉴权参数token
由于网络延迟等原因,系统不保证 token 在此值表示的有效期内绝对有效,如果发现 token 使用异常请重新获取新的 token
请求路径:
{HostName}/api/v2/op/token/
请求方式:
- 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分钟(有效时间5分钟)request_id
为接入方随机生成的唯一字符串,短时间内多次请求时,接入方需要保证这个值不重复。即在短时间内使用重复的request_id
请求,众趣方会认定这是非法请求。- app_id 与app_secret 参考对接前必看-对接流程文档
响应参数
{
"msg": "success",
"code": 1,
"data": {
"token": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM=",
"expire_in": 3600
}
}
响应参数字段及含义:
字段名 | 类型 | 是否必传 | 含义 |
---|---|---|---|
msg | string | 是 | 响应状态描述 |
code | int | 是 | 响应状态码 |
token | string | 是 | token |
expire_in | int | 是 | 过期时间 |
消息码code取值及说明:
code值 | 说明 |
---|---|
1 | 成功 |
31000 | 不支持当前请求的版本 |
33000 | 参数校验失败 |
33001 | 缺少必要的参数 |
32000 | 签名校验失败 |
32001 | request_id重复 |
32009 | token校验失败,token已过期 |