微信mp access_token获取接口
适用场景
access_token是微信公众号的全局唯一接口调用凭据,公众号调用各接口时都需使用access_token。
微信公众平台建议开发者使用中控服务器统一获取和刷新access_token,其他业务逻辑服务器所使用的access_token均来自于该中控服务器,不应该各自去刷新,否则容易造成冲突,导致access_token覆盖而影响业务;
此文档适用场景:广告主与热云业务均需要获取access_token
为避免冲突,热云不再向微信公众平台直接请求获取access_token,而是向中控服务器请求获取access_token,其中中控服务器可以是开发者服务器,亦可以是其他稳定可用的服务器,且均需保证access_token的有效性。
接口调用方式说明
请求方式
所有请求格式统一使用UTF-8编码,请求方式使用GET
由开发者侧提供接口URL。热云侧会通过GET方式直接调用该URL来获取access_token。
接口返回说明
返回样例
{
"status": 200,
"data": {
"access_token": "<微信mp返回的access_token>",
"over_time": <token超时时间。单位:秒>,
"message": null
}
}
字段说明
返回参数 | 是否必须 | 说明 |
---|---|---|
status | 是 | 获取access_token成功,则该值为200。其他情况返回500 |
access_token | 是 | 微信公众平台返回的access_token |
over_time | 是 | token超时时间。单位:秒。 |
message | 否 | 失败详细信息。便于排查问题。 |
注意事项
1、热云会定时获取与刷新access_token,频次为:每30分钟获取1次,若获取失败,则每隔1秒重试1次,共重试10次。
2、参数over_time返回值不可小于3600,即:传至热云的access_token有效期不可小于1小时。若因access_token有效期不足而导致的数据异常,请广告主慎重关注。
3、每次请求access_token的最长等待时间为2s,超出后视为请求失败。
4、请开发者严格保证唯一服务器的稳定性与及时性,严格保证传至热云的access_token的有效性与可用性。若因access_token获取失败、失效等引发的数据异常或业务问题,将会引发不可估量且无法挽回的损失,请广告主谨慎填写。