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

收藏
我的收藏

接口说明

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


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

数据类型

小程序接口

抖音开放平台

点赞数

可以获得

可以获得

视频封面

可以获得

可以获得

分享链接

不能获得

可以获得

转发数

不能获得

可以获得

评论数

不能获得

可以获得

下载数

不能获得

可以获得

播放数

不能获得

可以获得


前提条件

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

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

基本信息

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

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

请求参数

请求头
content-type必填String
示例:application/json
固定值"application/json"
Body展开全部子属性
access_key必填String

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

access_token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
app_id必填String

小程序 ID

video_ids必填List

video_id列表。要转换的 videoId 列表,最长为 100 个。在抖音及今日头条宿主小程序拍摄抖音能力获取。

展开子属性
请求示例
{ "app_id": "tt5d***", "video_ids": [ "131041******************", "131042******************", "131051******************" ], "access_key": "tt5d***********", "access_token": "0801121846********" }

响应参数

Body展开全部子属性
data必填Struct

返回数据

展开子属性
err_no必填Enum

错误号,成功时返回 0

err_tips必填String

错误信息

响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_tips": "", "data": { "convert_result": { "13104******": "Qy**************" } } }

错误码

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

传入的参数不合法

200-1

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

2000

返回成功