# 获取接口调用凭据

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

接口英文名:getAccessToken

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/cgi-bin/token

# 云调用

  • 本接口不支持云调用

# 第三方调用

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

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

参数名类型必填说明
grant_typestring填写 client_credential
appidstring账号的唯一凭证,即 AppID,点此查看如何获取Appid
secretstring唯一凭证密钥,即 AppSecret,点此查看如何获取AppSecret

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
access_tokenstring获取到的凭证
expires_innumber凭证有效时间,单位:秒。目前是7200秒之内的值。

# 4. 注意事项

# AppSecret 安全提醒

  • AppSecret是账号使用后台API接口的密钥,请开发者妥善保管,避免因泄露造成账号被其它人冒用等风险。如长期无AppSecret的使用需求,开发者可以使用对AppSeceret进行冻结,提高账号的安全性。AppSecret冻结后,开发者无法使用AppSecret获取Access token(接口返回错误码40243),不影响账号基本功能的正常使用,不影响通过第三方授权调用后台接口,不影响云开发调用后台接口。开发者可以随时对AppSecret进行解冻。
  • 点此查看如何冻结/解冻AppSecret

# 5. 代码示例

请求示例

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

返回示例

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

# 6. 错误码

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

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口
40002invalid grant_type不合法的凭证类型
40013invalid appid不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写
40125不合法的 secret请检查 secret 的正确性,避免异常字符,注意大小写
40164调用接口的IP地址不在白名单中请在接口IP白名单中进行设置
40243AppSecret已被冻结,请解冻后再次调用。点此查看如何解冻AppSecret
41004appsecret missing缺少 secret 参数
50004禁止使用 token 接口
50007账号已冻结

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
小程序公众号服务号小游戏微信小店联盟带货机构带货助手移动应用网站应用视频号助手多端应用
  • ✔:该账号可调用此接口
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;