抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端 API 介绍
  • 接口调用凭证
  • 登录
  • 直播间能力
  • 完成用户对局数据上报

    收藏
    我的收藏

    接口说明

    当完成用户对局数据上报后,调用本接口,标记对局数据上报已完成,小摇杆的「本局榜」将展示本局榜单数据。 未标记完成,本轮对局数据在小摇杆的「本局榜」中不展示。

    使用限制

    小玩法app_id纬度,qps限流配置为 100/s。

    基本信息

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

    请求参数

    请求头
    content-type必填String
    示例:application/json
    固定值"application/json"
    X-Token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    Body
    anchor_open_id必填String
    示例:xxxxx
    主播的open_id
    app_id必填String
    示例:tt411d37a0dxxxxx
    直播玩法app_id
    room_id必填String
    示例:7827382738223
    房间room_id
    round_id必填Int64
    示例:12
    一轮游戏的唯一标识
    complete_timeInt64
    示例:1722239345
    上传完成时间,由开发者传,秒级时间戳。不传的话,默认取当前接口调用的时间作为上传数据完成的时间
    请求示例
    curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/round/complete_upload_user_result' \ --header 'content-type: application/json' \ --header 'X-Token: 0801121846735352506a356a6' \ --data '{"complete_time":1722239345,"app_id":"tt411d37a0dxxxxx","round_id":1232,"anchor_open_id":"a84NH6Okrb","room_id":"7827382738223"}'

    响应参数

    Body
    err_msg必填String
    错误描述
    err_no必填Int64
    错误码,0代表成功
    响应示例
    正常响应示例异常响应示例
    { "err_no": 0, "err_msg": "" }
    切换单列布局

    错误码

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