# 获取接口调用凭据
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getAccessToken
- 获取全局唯一后台接口调用凭据,token有效期为7200s,开发者需要进行妥善保存。
- 如使用云开发,可通过云调用免维护 access_token 调用。
- 如使用云托管,也可以通过微信令牌/开放接口服务免维护 access_token 调用。
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/cgi-bin/token
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
无
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
grant_type | string | 是 | 填写 client_credential |
appid | string | 是 | 账号的唯一凭证,即 AppID,点此查看如何获取Appid |
secret | string | 是 | 唯一凭证密钥,即 AppSecret,点此查看如何获取AppSecret |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
access_token | string | 获取到的凭证 |
expires_in | number | 凭证有效时间,单位:秒。目前是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. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
40002 | invalid grant_type | 不合法的凭证类型 |
40013 | invalid appid | 不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写 |
40125 | 不合法的 secret | 请检查 secret 的正确性,避免异常字符,注意大小写 |
40164 | 调用接口的IP地址不在白名单中 | 请在接口IP白名单中进行设置 |
40243 | AppSecret已被冻结,请解冻后再次调用。 | 点此查看如何解冻AppSecret |
41004 | appsecret missing | 缺少 secret 参数 |
50004 | 禁止使用 token 接口 | |
50007 | 账号已冻结 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况:
小程序 | 公众号 | 服务号 | 小游戏 | 微信小店 | 联盟带货机构 | 带货助手 | 移动应用 | 网站应用 | 视频号助手 | 多端应用 |
---|---|---|---|---|---|---|---|---|---|---|
✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
- ✔:该账号可调用此接口
- 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;