请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/get_provider_token
请求包体:
{
"corpid":"xxxxx",
"provider_secret":"xxx"
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
corpid | 是 | 服务商的corpid |
provider_secret | 是 | 服务商的secret,在服务商管理后台可见 |
返回结果:
{
"provider_access_token":"enLSZ5xxxxxxJRL",
"expires_in":7200
}
参数说明:
参数 | 说明 |
---|---|
provider_access_token | 服务商的access_token,最长为512字节。 |
expires_in | provider_access_token有效期(秒) |
若调用失败,会返回errcode及errmsg字段。(开发者根据errcode字段存在且值非0,可认为是调用失败)
注意事项:
开发者需要缓存provider_access_token,用于后续接口的调用(注意:不能频繁调用get_provider_token接口,否则会受到频率拦截)。当provider_access_token失效或过期时,需要重新获取。
provider_access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的provider_access_token。
provider_access_token至少保留512字节的存储空间。
企业微信可能会出于运营需要,提前使provider_access_token失效,开发者应实现provider_access_token失效时重新获取的逻辑。