抖音开放平台与小程序视频打通能力
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
https://developer.toutiao.com/api/apps/convert_video_id/video_id_to_open_item_id
数据获取能力
videoId 转换为抖音开放平台可用的 item_id，从而提供获取更多数据的能力。需要注意的是：开放平台端获取数据也需要经过抖音开放平台的获取 access_token 流程，这部分请参阅抖音开放平台的文档。与原本数据获取能力的对比
| 数据类型 | 小程序接口 | 抖音开放平台 |
|---|---|---|
| 点赞数 | 可以获得 | 可以获得 |
| 视频封面 | 可以获得 | 可以获得 |
| 分享链接 | 不能获得 | 可以获得 |
| 转发数 | 不能获得 | 可以获得 |
| 评论数 | 不能获得 | 可以获得 |
| 下载数 | 不能获得 | 可以获得 |
| 播放数 | 不能获得 | 可以获得 |
请求地址
沙盒地址
POST https://open-sandbox.douyin.com/api/apps/convert_video_id/video_id_to_open_item_id请求验证
appid，更详细的内容请参见小程序获取抖音权限结尾部分。videoId 将会在结果中被静默忽略。当完成拍视频得到 videoId 后如果立即进行转换，因为服务端有延迟，一般是会失败的，建议先将 videoId 存到服务端，稍后再根据业务需要进行转换。
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://developer.toutiao.com/api/apps/convert_video_id/video_id_to_open_item_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"app_id": "tt5d***",
"video_ids": [
"131041******************",
"131042******************",
"131051******************"
],
"access_key": "tt5d***********",
"access_token": "0801121846********"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_tips": "string",
"data": {
"convert_result": {
"13104******": "string"
}
}
}修改于 2023-12-05 03:14:24