# 获取稳定版接口调用凭据

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：getStableAccessToken

• 获取全局后台接口调用凭据，有效期最长为7200s，开发者需要进行妥善保存；
• 有两种调用模式: 1. 普通模式，access_token 有效期内重复调用该接口不会更新 access_token，绝大部分场景下使用该模式；2. 强制刷新模式，会导致上次获取的 access_token 失效，并返回新的 access_token；
• 该接口调用频率限制为 1万次 每分钟，每天限制调用 50万 次；
• 与getAccessToken获取的调用凭证完全隔离，互不影响。该接口仅支持 POST JSON 形式的调用；
• 如使用云开发，可通过云调用免维护 access_token 调用；
• 如使用云托管，也可以通过微信令牌/开放接口服务免维护 access_token 调用；

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/stable_token

# 云调用

• 本接口不支持云调用

# 第三方调用

• 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

无

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

1. 该接口调用频率限制为 1万次 每分钟，每天限制调用 50w 次；与获取接口调用凭据的凭证完全隔离，互不影响。
2. 该接口仅支持 POST JSON 形式的调用；
3. "access_token存储空间至少保留512字符",
4. "强制刷新模式每天限用20次且需间隔30秒",
5. "普通模式下平台会提前5分钟更新access_token"

# 5. 代码示例

# 5.1 不强制刷新获取Token（不传递force_refresh，默认值为false）

请求示例

POST https://api.weixin.qq.com/cgi-bin/stable_token

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET"
}

返回示例

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

# 5.2 不强制刷新获取Token（设置force_refresh为false）:

请求示例

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET",
    "force_refresh": false
} 

返回示例

{
    "access_token":"ACCESS_TOKEN",
    "expires_in":345 // 如果仍然有效，会返回上次的 token，并给出所剩有效时间
} 

# 5.3 强制刷新模式，慎用，连续使用需要至少间隔30s

请求示例

POST https://api.weixin.qq.com/cgi-bin/stable_token

{
    "grant_type": "client_credential",
    "appid": "APPID",
    "secret": "APPSECRET",
    "force_refresh": true
} 

返回示例

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

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码

# 7. 适用范围