通过 ItemID 获取 iFrame 代码
收藏该接口无需申请权限。
该接口适用于抖音。
注意：
该接口以
https://open.douyin.com/ 开头。请求地址
GET /api/douyin/v1/video/get_iframe_by_item
请求参数
URL 请求
参数名称 | 参数描述 | 参数示例 | 是否必填 |
item_id | 视频ItemID(请注意使用Base64URL编码) | QDcyTTBXQ3F0eHVZR2l3dGtWVVlGdkgxbnR1TTBSZlF3VkgrUmZUMzBXVVY4Q3RMUXJVOU1wSlNZRVZWNi8yaEsrTm8zQVBUYy84T1U3VkJiQkhJM3NnPT0= | 是 |
client_key | 应用标识 | awexxxxxxx | 是 |
请求样例
curl --location --request GET 'https://open.douyin.com/api/douyin/v1/video/get_iframe_by_item?item_id=QDcyTTBXQ3F0eHVZR2l3dGtWVVlGdkgxbnR1TTBSZlF3VkgrUmZUMzBXVVY4Q3RMUXJVOU1wSlNZRVZWNi8yaEsrTm8zQVBUYy84T1U3VkJiQkhJM3NnPT0=&client_key=awexxxxxxx'
响应参数
参数名称 | | 参数类型 | 参数描述 | 参数示例 |
err_no | | i32 | 错误码 | 0 |
err_msg | | string | 错误码描述 | 非公开视频 |
log_id | | string | 日志ID | 20221025205044010225243125063FAD62 |
data | | object | | |
| iframe_code | string | 返回IFrame代码片段，用于直接注入页面 | |
| video_title | string | 视频标题 | 天气不错 |
| video_width | i64 | 视频宽度 | 1280 |
| video_height | i64 | 视频高度 | 720 |
响应样例
{ "data": { "iframe_code": "<iframe width=\"720\" height=\"1280\" frameborder=\"0\" src=\"https://open.douyin.com/player/video?vid=7146408143612******&autoplay=0\" referrerpolicy=\"unsafe-url\" allowfullscreen></iframe>", "video_height": 1280, "video_title": "#hashtag1#hashtag2#hashtag3#天气不错", "video_width": 720 }, "err_msg": "", "err_no": 0, "log_id": "20221025205044010225243125063FAD62" }
响应错误样例
{ "err_msg": "系统内部错误，请重试", "err_no": 28001005, "log_id": "20221025205044010225243125063FAD62" }
错误码
HTTP 状态码 | 错误码 | 描述 | 排查建议 |
200 | 28001005 | 系统内部错误，请重试 | 请求重试，或反馈给抖音开放平台 |
200 | 28001007 | 参数不合法 | 检查参数是否正确 |
200 | 28003004 | 非公开视频 | 检查当前视频是否处于公开状态 |
