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

上报连麦对局内用户积分

收藏
我的收藏

接口说明

上报连麦对局内用户积分

使用限制

小玩法 app_id 维度,qps 限流配置为 200/s。

基本信息

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

请求参数

请求头
content-type必填String
示例:application/json
固定值"application/json"
x-token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body展开全部子属性
anchor_infosList
对局关联的直播房间列表,目前仅支持传入 1 个
展开子属性
app_idString
小玩法 app_id
round_idInt64
一轮游戏的唯一标识
round_statusInt64
对局状态,枚举值:1 开始;2 结束;3 进行中
user_listList
参与游戏的用户列表
展开子属性
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/round/co_game_upload_user_data' \ --header 'X-Token: 08011218462f4f516b53xxx' \ --header 'Content-Type: application/json' \ --data-raw '{"app_id":"ttb101c7bc2e30xxxxxx","round_id":1,"round_status":1,"anchor_infos":[{"anchor_open_id":"xxxx","room_id":"741033347597639xxxx"}],"user_list":[{"open_id":"xxxx","score":396}]}'

响应参数

Body展开全部子属性
err_codeInt64
错误码,0代表成功
err_msgString
错误描述
fail_room_listList
失败的房间信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "errcode": 0, "errmsg": "" }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
20040001

参数错误

房间 id、小玩法 app_id 等入参解析失败,检查参数解析逻辑

20040007

请求过于频繁

接口有频控限制,建议降低请求的并发量

20040004

access_token 过期

重新生成 access_token

20050048

观众一键同玩能力繁忙

观众一键同玩能力繁忙,暂停使用