抖音开放平台Logo
控制台

抖音开放平台与小程序视频打通能力

收藏
我的收藏

接口说明

提供将在抖音及今日头条宿主小程序拍摄抖音能力获取的 videoId 转换为抖音开放平台可用的 item_id，从而提供获取更多数据的能力。需要注意的是：开放平台端获取数据也需要经过抖音开放平台的获取 access_token 流程，这部分请参阅抖音开放平台的文档。

与原本数据获取能力的对比

数据类型

小程序接口

抖音开放平台

点赞数

可以获得

可以获得

视频封面

可以获得

可以获得

分享链接

不能获得

可以获得

转发数

不能获得

可以获得

评论数

不能获得

可以获得

下载数

不能获得

可以获得

播放数

不能获得

可以获得


提供将抖音和小程序平台的视频信息互换使用的能力。开发者可以通过将小程序平台的视频转换到抖音开放平台，从而提供更丰富的视频相关资源和数据获取能力，另一方面，也可以通过从开放平台转换获取存量视频进行内容聚合和存量内容使用，扩大小程序的视频使用能力。​

另外，关于打通功能，推荐阅读：小程序获取抖音权限​

数据获取能力​

提供将在抖音及今日头条宿主小程序拍摄抖音能力获取的 videoId 转换为抖音开放平台可用的 item_id，从而提供获取更多数据的能力。需要注意的是：开放平台端获取数据也需要经过抖音开放平台的获取 access_token 流程，这部分请参阅抖音开放平台的文档。​

与原本数据获取能力的对比​

​

数据类型​

小程序接口​

抖音开放平台​

点赞数​

可以获得​

可以获得​

视频封面​

可以获得​

可以获得​

分享链接​

不能获得​

可以获得​

转发数​

不能获得​

可以获得​

评论数​

不能获得​

可以获得​

下载数​

不能获得​

可以获得​

播放数​

不能获得​

可以获得​

​

前提条件

提供将抖音和小程序平台的视频信息互换使用的能力。开发者可以通过将小程序平台的视频转换到抖音开放平台，从而提供更丰富的视频相关资源和数据获取能力，另一方面，也可以通过从开放平台转换获取存量视频进行内容聚合和存量内容使用，扩大小程序的视频使用能力。

另外，关于打通功能，推荐阅读：小程序获取抖音权限

基本信息

名称描述
HTTP URL
HTTP Method
POST
Scope
app.upload.live_page
权限要求

请求需要验证授权，详见验证授权

请求头

名称字段类型是否必填示例描述
content-typeString是application/json
固定值"application/json"

请求参数

Body

名称字段类型是否必填示例描述
access_keyString是

字段含义：小程序id或移动网站应用id；备注：填写转化为目标应用的应用ID，如果转化为本小程序可用的itemId，填入本小程序的appid即可。

access_tokenString是clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/client_token/生成的token
app_idString是

小程序 ID

请求示例

{
  "app_id": "tt5d***",
  "video_ids": [
    "131041******************",
    "131042******************",
    "131051******************"
  ],
  "access_key": "tt5d***********",
  "access_token": "0801121846********"
}

响应参数

Body

名称字段类型是否必填示例描述
err_noEnum是

错误号，成功时返回 0

err_tipsString是

错误信息

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "",
  "data": {
    "convert_result": {
      "13104******": "Qy**************"
    }
  }
}

异常响应示例

{
  "err_no": -1,
  "err_tips": "VideoIdToOpenItemId 服务器内部错误"
}

错误码

http状态码错误码错误码描述排查建议
20011009

传入的参数不合法

200-1

服务器出错，请稍后重试或验证请求是否合法

2000

返回成功