获取第三方小程序接口调用凭据V2
收藏
我的收藏接口说明
该接口用于获取第三方小程序应用的接口调用凭据。
第三方小程序应用接口调用凭据 component_access_token 是服务商进行后续授权步骤,以及调用第三方小程序相关接口的必要参数。
使用限制
- 每个 component_access_token 有效期是 2 小时,重复获取会使上次的 component_access_token 失效(但有 5 分钟的缓冲时间,连续多次获取 component_access_token 只会保留最新的两个 component_access_token)。
- 通过该接口获取到的 component_access_token 为V2版component_access_token,与 V1 版component_access_token 不可混用;
- 各 OpenAPI 使用的 component_access_token 类型需要参考接口文档里 access-token 参数的说明,只有特别标注使用 V2 版 component_access_token 才可使用本接口获取到的 component_access_token 进行调用;
- 后续新增的第三方小程序相关接口都只支持通过 V2 版 component_access_token 进行调用;
- 存量的接口会逐步推出和V2 版 component_access_token 相匹配的新接口,存量接口仍可用,但建议开发者迁移使用新接口;
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/openapi/v2/auth/tp/token/ |
HTTP Method | GET |
Scope | thirdparty.dev.auth |
请求参数
Query
component_appid必填String
第三方小程序应用 appid
component_appsecret必填String
第三方小程序应用 appsecret
component_ticket必填String
推送的 component_ticket
请求示例
curl --location 'https://open.douyin.com/openapi/v2/auth/tp/token?component_appid=xxxxx&component_appsecret=xxxxx&component_ticket=xxxxx'
响应参数
Body
component_access_token必填String
第三方小程序应用接口调用凭据
expires_in必填Int64
有效期,单位:秒
errnoString
错误码, 只有当错误时返回
messageString
错误描述, 只有当错误时返回
响应示例
正常响应示例异常响应示例
{ "expires_in": 3600, "component_access_token": "xxxxx" }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | |
200 | 40003 | 找不到相关第三方小程序应用 | |
200 | 40037 | 无效的 ticket | |
200 | 40038 | 无效的 secret | |
200 | 40045 | 生成 token 失败,请重试 |
点击纠错