获取access_token
获取access_token是调用企业微信API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。
请求方式: GET(HTTPS)
请求地址: https://open.wshoto.com/openapi/access_token?appid=APPID&app_secret=SECRET
注:此处标注大写的单词APPID和SECRET,为需要替换的变量,根据实际获取值更新。其它接口也采用相同的标注,不再说明。
如何获取APPID及SECRET
参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
appid | string | 是 | 企微管家颁发给开发者的应用ID |
app_secret | string | 是 | 企微管家颁发给开发者的应用secret |
返回结果:
{
"code":0,
"msg": "ok",
"data": {
"access_token": "aGV0bTJidHh4ZXlmNnEwOXBub2sxdGgxeWJwbXgxb2"
"expires_in": 7200,
"create_at": 1654841208
}
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | AccessToken | |
access_token | string | 获取到的凭证,最长为512字节 |
expires_in | long | 凭证的有效时间(秒) |
create_at | long | 创建时间(时间戳) |
注意事项:
开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用token接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。
access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。
access_token至少保留512字节的存储空间。
企微管家可能会出于运营需要,提前使access_token失效,开发者应实现access_token失效时重新获取的逻辑。