视频使用能力能力

开发环境

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	服务器出错，请稍后重试或验证请求是否合法

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/convert_video_id/open_item_id_to_encrypt_id' \
--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"
    }
  }
}

请求参数

Body 参数application/json

video_ids

array[string]

必需

要转换的 item_id 列表，最长为 100 个

access_key

string

必需

访问密钥，详情见下表

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

错误号，成功时返回 0

err_tips

string

必需

错误信息，成功时返回空

data

object

见下文结构说明

必需

convert_result

object

必需

🟠400请求有误

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

开放能力配置接口

视频使用能力能力

沙盒地址#

errCode#

请求参数

返回响应

沙盒地址

errCode