上报用户对局数据
接口说明
对局结束后,上报用户对局数据,分批次上报,单批次最多上报50个用户对局数据。
使用限制
小玩法app_id纬度,qps限流配置为 100/s。
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://webcast.bytedance.com/api/gaming_con/round/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
room_idString
round_idInt64
一轮游戏的唯一标识
user_listList
参与游戏的观众列表
展开子属性
请求示例
curl --location --request POST '/api/gaming_con/round/upload_user_result' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"user_list":[{"rank":37437806498534100,"score":5990149378627985016,"winning_streak_count":8147069557039827691,"winning_points":3830235313023821922,"round_result":1,"open_id":"9Fyvedjs4D"}],"app_id":"VKsZ453nL9","round_id":303492444183698453,"anchor_open_id":"Q5xb4Czsnp","room_id":"kyYlk9vGGS"}' # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看
响应参数
响应示例
{ "err_no": 5169311031097889000, "err_msg": "0YXSTlxEgn" }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | 请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配、请求头是否正确填写 |
200 | 4014034 | 请求过于频繁 | 接口有频控限制,建议降低请求的并发量 |
200 | 40004 | access_token过期 | 重新生成access_token |
200 | 10011 | 用户对局信息不存在 | 请检查是否同步过对局状态信息 |