接口说明

对局结束后，上报用户对局数据，分批次上报，单批次最多上报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

固定值"application/json"

X-Token必填String

示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d

调用https://developer.toutiao.com/api/apps/v2/token生成的token

Body展开全部子属性

anchor_open_id必填String

主播的open_id

app_id必填String

直播玩法app_id

room_id必填String

对局Id

round_id必填Int64

一轮游戏的唯一标识

user_list必填List

参与游戏的观众列表

展开子属性

请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/round/upload_user_result' \
--header 'content-type: application/json' \
--header 'X-Token: 0801121846735352506a356a6' \
--data '{"anchor_open_id":"R31PlZy6fL","room_id":"1003434343","user_list":[{"rank":12,"score":322,"winning_streak_count":1232,"winning_points":4223,"round_result":1,"open_id":"i4WwTDWUGP", "group_id":"test-01"}],"app_id":"tt411d37a0dxxxxx","round_id":213}'

响应参数

Body

err_msg必填String

错误描述

err_no必填Int64

错误码，0代表成功

响应示例
正常响应示例异常响应示例
{
  "err_code": 0,
  "err_msg": ""
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	40001	参数错误	请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配、请求头是否正确填写
200	4014034	请求过于频繁	接口有频控限制，建议降低请求的并发量
200	40004	access_token过期	重新生成access_token
200	10011	用户对局信息不存在	请检查是否同步过对局状态信息

上报用户对局数据在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

上报用户对局数据