抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 直播玩法 OpenAPI SDK 总览
  • 服务端 API 介绍
  • 接口调用凭证
  • 直播间能力
  • 错误码
  • 数据开放
  • 直播信息
  • 获取题库
  • 常见问题
  • 礼物进阶互动效果
  • 礼物进阶互动效果接入说明
  • 同步对局状态
  • 上报阵营数据
  • 查询观众阵营数据(开发者提供)
  • 用户战绩与排行榜
  • 用户快捷选队
  • 观众一键同玩能力
  • 接口说明

    该接口提供同步对齐状态的能力,开发者在对局开始时调用,同步对局开始事件;在对局结束时再次调用,同步对局结束事件

    使用限制

    单玩法id,每秒最多调用3次

    基本信息

    名称描述
    HTTP URL
    https://webcast.bytedance.com/api/gaming_con/round/sync_status
    HTTP Method
    POST
    Scope
    interactive_rank_config

    请求参数

    请求头
    content-type必填String
    固定值"application/json"
    X-Token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    Body展开全部子属性
    anchor_open_idString
    主播openid
    app_idString
    玩法id
    end_timeInt64
    本局结束时间,秒级时间戳
    group_result_listList
    对局阵型结果
    展开子属性
    room_idString
    房间ID
    round_idInt64
    对局ID
    start_timeInt64
    本局开始时间,秒级时间戳
    statusEnum
    当前房间的游戏对局状态
    展开子属性
    请求示例
    curl --location --request POST '/api/gaming_con/round/sync_status' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"group_result_list":[{"result":1,"group_id":"ivUdnO5q4p"}],"round_id":2147308014372294696,"room_id":"2wwxt9Jabx","app_id":"StdQpnPbQH","anchor_open_id":"yetwUB6Aoh","start_time":1341160109263904954,"end_time":6173450157488487144,"status":1}' # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看

    响应参数

    响应示例
    { "err_no": 7068553219744718000, "err_msg": "QxZUM2b6Fw" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20040001
    参数错误
    请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配、请求头是否正确填写
    2004014034
    请求过于频繁
    接口有频控限制,建议降低请求的并发量
    20040004
    access_token过期
    重新生成access_token,重新请求