# 获取AccessToken

本接口应在服务器端调用，详细说明参见服务端API。

获取橱窗全局唯一后台接口调用凭据（access_token）。调用绝大多数后台接口时都需使用 access_token，开发者需要进行妥善保存。

GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

属性	类型	必填	说明
grant_type	string	是	填写 client_credential
appid	string	是	开放唯一凭证，即账号ID，可在「视频号助手 - 直播 - 开放能力」中获得。（需要已完成橱窗开放的开通，且账号没有异常状态）
secret	string	是	开放唯一凭证密钥，即账号密钥，获取方式同账号ID

返回的 JSON 数据包

错误码	错误信息	最低版本
公共错误码	点击查看
0	请求成功
40001	AppSecret 错误或者 AppSecret 不属于这个橱窗，请开发者确认 AppSecret 的正确性
40002	请确保 grant_type 字段值为 client_credential
40013	不合法的 AppID，请开发者检查 AppID 的正确性，避免异常字符，注意大小写
40125	不合法的 secret ，请检查 secret 的正确性，避免异常字符，注意大小写
40164	调用接口的IP地址不在白名单中，请在接口IP白名单中进行设置
41004	缺少 secret 参数
50004	禁止使用 token 接口
50007	账号已冻结
61024	第三方平台 API 需要使用第三方平台专用 token

正常返回

{
    "access_token": "ACCESS_TOKEN",
    "expires_in": 7200
}

错误时返回

{
    "errcode": 40013,
    "errmsg": "invalid appid"
}

access_token 的存储至少要保留 512 个字符空间；
access_token 的有效期目前为 2 个小时 ，需定时刷新，重复获取将导致上次获取的 access_token 失效；
建议开发者使用中控服务器统一获取和刷新 access_token，其他业务逻辑服务器所使用的 access_token 均来自于该中控服务器，不应该各自去刷新，否则容易造成冲突，导致 access_token 覆盖而影响业务；
access_token 的有效期通过返回的 expires_in 来传达，目前是7200秒之内的值，中控服务器需要根据这个有效时间提前去刷新。在刷新过程中，中控服务器可对外继续输出的老 access_token，此时公众平台后台会保证在5分钟内，新老 access_token 都可用，这保证了第三方业务的平滑过渡；
access_token 的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新 access_token 的接口，这样便于业务服务器在 API 调用获知 access_token 已超时的情况下，可以触发 access_token 的刷新流程。