视频使用能力能力

开发环境

http://dev-cn.your-api-server.com

POST

https://developer.toutiao.com/api/apps/convert_video_id/open_item_id_to_encrypt_id

提供将在抖音开放平台获取的 item_id 转换为小程序中可用的 encryptedId，从而在小程序宿主中播放。通过这一能力，可以将原先无法获取的用户存量视频在字节小程序中使用。参见跳转视频播放页。

沙盒地址

POST https://open-sandbox.douyin.com/api/apps/convert_video_id/open_item_id_to_encrypt_id

access_key 逻辑

根据打通文档的说明，此处在使用的应用类型为小程序时应当为小程序的 appid。具体内容参见上面的 access_key 说明

errCode

当请求失败时，会返回非 0 的err_no，错误信息会携带在 err_tips 中，错误码含义如下：

错误号	描述
11009	传入的参数不合法
-1	服务器出错，请稍后重试或验证请求是否合法

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

🟠400请求有误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/convert_video_id/open_item_id_to_encrypt_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "video_ids": [
    "@ty******************",
    "@ty******************",
    "@ty******************"
  ],
  "access_key": "tt*************"
}'

响应示例

200 - 示例 1

{
    "err_no": 0,
    "err_tips": "string",
    "data": {
        "convert_result": {
            "@ty******************": "string"
        }
    }
}

修改于 2023-12-05 03:17:00

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

开放能力配置接口

视频使用能力能力

沙盒地址#

errCode#

请求参数

返回响应

沙盒地址

errCode