- 调用格式说明
- Postman模板使用说明
- 第三方小程序应用密钥使用说明
- 第三方小程序应用上传资源
- 第三方小程序应用上传资源V2
- 授权
- 域名
- 模板管理
- 代商家管理小程序
- 代商家入驻抖音开放平台
获取第三方小程序接口调用凭据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 | 是 | 有效期,单位:秒 | |
errno | String | 否 | 错误码, 只有当错误时返回 | |
message | String | 否 | 错误描述, 只有当错误时返回 |
响应示例
正常响应示例
{
"expires_in": 3600,
"component_access_token": "xxxxx"
}
异常响应示例
{
"errno": 40037,
"message": "无效的 ticket"
}
错误码
http状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | |
200 | 40003 | 找不到相关第三方小程序应用 | |
200 | 40037 | 无效的 ticket | |
200 | 40038 | 无效的 secret | |
200 | 40045 | 生成 token 失败,请重试 |
该文档是否有帮助?
点击纠错