获取第三方小程序接口调用凭据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 状态码错误码错误码描述排查建议
20040001
参数错误
20040003
找不到相关第三方小程序应用
20040037
无效的 ticket
20040038
无效的 secret
20040045
生成 token 失败,请重试