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

上报阵营数据

收藏
我的收藏

接口说明

观众通过评论、点赞、送礼等方式加入玩法时,调用该接口上报当前观众的阵营数据。

使用限制

小玩法app_id纬度,限流配置为 1000/s。

基本信息

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

请求参数

请求头
content-type必填String
示例:application/json
固定值"application/json"
X-Token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body
app_id必填String
玩法id
group_id必填String
阵营id,取值来源来自开发者平台「用户战绩与排行榜」的GroupID
open_id必填String
用户openID
room_id必填String
房间ID
round_id必填Int64
对局ID,开发者自定义
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/round/upload_user_group_info' \ --header 'X-Token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"open_id":"mGYZLfwsH9","group_id":"test-111","round_id":1213,"room_id":"76886868223","app_id":"tt411d37a0xxxx"}'

响应参数

Body
err_msg必填String
错误描述
err_no必填Int64
错误码,0代表成功
响应示例
正常响应示例异常响应示例
{ "err_code": 0, "err_msg": "" }
切换单列布局

错误码

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