# 获取sdk临时票据

调试工具

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

接口英文名:getTicket

Api_ticket 是用于调用 js-sdk 的临时票据,有效期为7200 秒,通过access_token 来获取。

# 1. 调用方式

# HTTPS 调用

GET https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=TYPE

# 云调用

  • 本接口不支持云调用

# 第三方调用

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

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstring-接口调用凭证,可使用 access_tokenauthorizer_access_token
typestringjsapiticket 类型,jsapi 为 js-sdk 凭证;wx_card 为微信卡券凭证

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
ticketstring临时票据
expires_innumber有效期(秒)
errcodenumber错误码
errmsgstring错误信息

# 4. 注意事项

由于获取 api_ticket 的 api 调用次数非常有限,频繁刷新api_ticket 会导致api调用受限,影响自身业务,开发者需在自己的服务存储与更新api_ticket。

# 5. 代码示例

请求示例

https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=wx_card

返回示例

{
  "errcode":0,
  "errmsg":"ok",
  "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKdvsdshFKA",
  "expires_in":7200
}

# 6. 错误码

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

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
40001invalid credential  access_token isinvalid or not latest获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
服务号移动应用网站应用
仅认证
  • 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
  • ✔:该账号可调用此接口
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;