获取第三方小程序接口调用凭据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_appidString

第三方小程序应用 appid

component_appsecretString

第三方小程序应用 appsecret

component_ticketString

推送的 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_tokenString

第三方小程序应用接口调用凭据

expires_inInt64

有效期,单位:秒

errnoString
错误码, 只有当错误时返回
messageString
错误描述, 只有当错误时返回

响应示例

正常响应示例

{
  "expires_in": 3600,
  "component_access_token": "xxxxx"
}

异常响应示例

{
  "errno": 40037,
  "message": "无效的 ticket"
}

错误码

http状态码错误码错误码描述排查建议
20040001
参数错误
20040003
找不到相关第三方小程序应用
20040037
无效的 ticket
20040038
无效的 secret
20040045
生成 token 失败,请重试