抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端 API 介绍
  • 接口调用凭证
  • 登录
  • 直播间能力
  • 直播信息

    收藏
    我的收藏

    接口说明

    主播使用直播伴侣或移动端云启动玩法后,直播伴侣/移动端云启动会传入 token 到玩法中,当玩法获取 token 后,传递给玩法的服务端。玩法服务端通过该接口,使用 token 获取直播间信息。 token 有效期为 30 分钟。

    使用限制

    频率限制:单个 app_id 调用上限为 10 次/秒。

    基本信息

    名称描述
    HTTP URL
    https://webcast.bytedance.com/api/webcastmate/info
    HTTP Method
    POST
    Scope
    webcastmate_info

    请求参数

    请求头
    content-type必填String
    示例:application/json
    固定值"application/json"
    x-token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    Body
    token必填String
    获取到的 token
    请求示例
    curl --location --request POST 'http://webcast.bytedance.com/api/webcastmate/info' \ --header 'X-Token: 080112184630394f5735585a344f74546645794b544b786f30413d3d' \ --header 'Content-Type: application/json' \ --data-raw '{ "token":"pJKr395h6O5x2ykBjgrBIxnuot8nn62djr70EocUFXtiN1s9VpsHHuEPdZYKHVJFzftyIOb8lj9i0lrLnUhQsK55pT8shfX98qGuUBO7PSKoIVRq6tWMRdsjPVw=" }'

    响应参数

    Body展开全部子属性
    dataStruct
    响应数据
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "data": { "ack_cfg": [ // 预留信息,sdk接入使用,开发者不用感知 ], "linker_info": { // 连屏数据预留信息,开发者目前不用感知 "linker_id": 0, "linker_status": 0, "master_status": 0 }"info": { "room_id": 7214015683695250235, "anchor_open_id": "_000oJIu6APhomK7KIBGqSYm5XYPxCJB_xxx", "avatar_url": "https://p11.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_973c31e8055f78a41d3f7de3def9821d.jpeg?from=3067671334", "nick_name": "xxx" } } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20040001
    参数有误
    20040002
    通常为小程序没有该项能力
    20040007
    调用频率过高
    200-1
    服务内部异常