获取access_token

获取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失效时重新获取的逻辑。