获取accessToken

accessToken是Gzlle API的全局唯一接口调用凭据，Gzlle API调用各接口时都需使用accessToken。开发者需要进行妥善保存。accessToken的存储至少要保留512个字符空间。accessToken的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的accessToken失效。

Gzlle API调用所需的accessToken的使用及生成方式说明：

1、建议开发者使用中控服务器统一获取和刷新accessToken，其他业务逻辑服务器所使用的accessToken均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致accessToken覆盖而影响业务；

2、目前accessToken的有效期通过返回的expireIn来传达，默认是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新accessToken 来访问接口；

3、accessToken的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新accessToken的接口，这样便于业务服务器在API调用获知accessToken已超时的情况下，可以触发accessToken的刷新流程。

AppKey 和AppSecret 获取流程详见对接流程第4步：获取(配置)对接秘钥信息。

使用说明\ 将获取到的 accessToken （JWT https://jwt.io/ ）加入请求头(Http headers)中作为公共参数附带传输至应用API接口来使用。headers认证字段格式如下（注意在accessToken前面有常量 Bearer字符串）

-- Http Headers --
Authorization: Bearer [accessToken]

注意事项：‌

• accessToken有一定效期，生成token需要一定的资源开销，建议将token缓存在本地，请尽量重复使用token；请避免每次请求前都重新获取token，以免加长接口响应时间。

接口调用请求说明

请求地址

-- HTTPS POST --
https://openapi.gzlle.com/token

{"grantType":"client_credentials","appKey":"[appKey]","appSecret":"[appSecret]"}

参数说明

响应说明

正常情况下，API会返回下述JSON数据包：

{"accessToken":"[ACCESS_TOKEN]","expiresIn":7200}

响应参数

错误时API会返回HttpStatusCode错误码和错误JSON数据包示例如下（该示例为AppKey无效错误）:

{"error":"NotFound,"message":"invalid appKey"}

错误说明