v1.app.token - Tencent-WSQ-DEV/AppCenter GitHub Wiki

1.请求说明

名称 内容
请求URL http(s)://openapi.wsq.qq.com/v1/app/token
请求方法 GET
数据格式 JSON

2.请求参数说明

参数名 说明 备注
appId 应用Id
sig 应用签名
time 客户端发起请求时候的时间戳
type 校验类型 统一传 security

请求参数请遵守 RFC 1738,对参数进行 encode

2.1 签名算法

$sig = sha1($appId . $appSecret . $time);

2.2 time参数说明

time 参数是客户端发起请求时候的时间戳,请保证客户端服务器时间准确,否则会报错,可容忍的误差目前为 300s。

如果客户端时间与微社区服务器的时间不一致,将会返回错误,错误信息中会将客户端传递的时间与对比时使用的服务器时间返回。

注意,这里返回的服务器时间不是当前时间,而是对请求做校验时候的时间。

3.返回参数说明

参数名 说明 备注
appToken 应用登录态
expires 应用登录态的有效时间,单位:秒 目前有效时间返回 86400,但有可能更改,请以接口返回为准

4.请求示例

http(s)://openapi.wsq.qq.com/v1/app/token?
appId=**********************&
sig=************************&
time=1411203819&
type=security

5.返回示例

5.1 正确返回

{
 errCode: 0,
 errMsg: ,
 data: {
   appToken: "RE7ztSaiK8GF6Kr58ZmmhpUy1sUIDSdBkJJTqFLC6Ksg/Xmx0S+len15jNy+YCva7G1iU8s664No0ZCNYpzURIo+py5udwq4PwYIV5+NW1ZXXQs+d8zZGDsu9qdG0QMF",
   expires: 86400
 }
}

5.2 错误返回

{
 errCode: 2006,
 errMsg: 'error message'
}