抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 测试目录(勿动)
  • 其它
  • 抖音开放平台与小程序视频打通能力
  • 上传资源
  • 抖音开放平台与小程序视频打通能力

    收藏
    我的收藏

    接口说明

    提供将在抖音及今日头条宿主小程序拍摄抖音能力获取的 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必填Array<String>

    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

    返回成功