完成用户对局数据上报
接口说明
当完成用户对局数据上报后,调用本接口,标记对局数据上报已完成,小摇杆的「本局榜」将展示本局榜单数据。
未标记完成,本轮对局数据在小摇杆的「本局榜」中不展示。
使用限制
小玩法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 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | 请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配等、请求头是否正确填写 |
200 | 4014034 | 请求过于频繁 | 接口有频控限制,建议降低请求的并发量 |
200 | 40004 | access_token过期 | 重新生成access_token,重新请求 |