获取access_token是调用有数API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。 因此开发者,在使用业务接口前,要明确access_token的颁发来源,使用正确的access_token。
注:此处标注大写的单词KEY和SECRET,为需要替换的变量,根据实际获取值更新。其它接口也采用相同的标注,不再说明。
| 参数 | 参数类型 | 是否必须 | 说明 | 示例 |
|---|---|---|---|---|
| app_key | str | 否 | 在开放平台中获取的app_key | balabala |
| app_secret | str | 否 | 在开放平台中获取的app_secret | balabala |
每个轻应用都有独立的app_secret,所以每个轻应用的access_token应该分开获取
{
"error_code": 0,
"message": "Success",
"result": {
"access_token": "xxxxxxxxc16de11e99726acde00000000",
"expires_in": 7200
}
}
| 参数 | 说明 |
|---|---|
| error_code | 返回码,为0表示成功,非0表示调用失败 |
| message | 返回码提示语 |
| access_token | 获取到的凭证,最长为32个字符 |
| expires_in | 凭证的有效时间(秒) |
开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用gettoken接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。
access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。 由于有数中每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。 access_token至少保留32个字符的存储空间。
有数可能会出于运营需要,提前使access_token失效,开发者应实现access_token失效时重新获取的逻辑。