获取access_token

获取access_token是调用赢在销客API接口的第一步,相当于创建了一个登录凭证,其它的业务API接口,都需要依赖于access_token来鉴权调用者身份。
因此开发者,在使用业务接口前,要明确access_token的颁发来源,使用正确的access_token。

请求方式:POSTHTTPS
请求地址:https://www.wininsales.com/open/auth/get_access_token

参数说明:

参数 必须 说明
app_id 开放应用id,获取方式参考:
secret 应用的密钥secret

权限说明:
每个应用有独立的secret,所以每个应用的access_token应该分开来获取
返回结果:

{
   "code": 0,
   "msg": "ok",
   "access_token": "accesstoken000001",
   "timelimit": 7200
}

参数说明:

参数 说明
code 出错返回码,为0表示成功,非0表示调用失败
msg 返回码提示语
access_token 获取到的凭证,最长为512字节
timelimit 凭证的有效时间(秒)

注意事项:
开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用get_access_token接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。

access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。
由于企业微信每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。
access_token至少保留512字节的存储空间。
企业微信可能会出于运营需要,提前使access_token失效,开发者应实现access_token失效时重新获取的逻辑。

关于惠岚|用户协议|帮助中心© 2012- 2020 Huilan Inc. All Rights Reserved

results matching ""

    No results matching ""