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'
}