微信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_timetoken超时时间。单位:秒。
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获取失败、失效等引发的数据异常或业务问题,将会引发不可估量且无法挽回的损失,请广告主谨慎填写。