抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

完成用户对局数据上报

收藏
我的收藏

接口说明

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

使用限制

小玩法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"
X-Token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body
anchor_open_idString
app_idString
complete_timeInt64
全部用户对局数据上传完成时间
room_idString
round_idInt64
一轮游戏的唯一标识
请求示例
curl --location --request POST '/api/gaming_con/round/complete_upload_user_result' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"anchor_open_id":"SrbYzdtOp9","room_id":"hDzwhGQDl6","complete_time":700487192863703639,"app_id":"yx1yq1ZI68","round_id":1043812011218398826}' # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看

响应参数

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

错误码

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