同步对局状态
接口说明
该接口提供同步对齐状态的能力,开发者在对局开始时调用,同步对局开始事件;在对局结束时再次调用,同步对局结束事件
使用限制
单玩法id,每秒最多调用3次
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://webcast.bytedance.com/api/gaming_con/round/sync_status |
HTTP Method | POST |
Scope | interactive_rank_config |
请求参数
请求头
content-type必填String
示例:application/json
固定值"application/json"
X-Token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body展开全部子属性
anchor_open_id必填String
主播的openid
app_id必填String
玩法id
room_id必填String
房间ID
round_id必填Int64
对局ID
start_time必填Int64
本局开始时间,秒级时间戳
end_timeInt64
本局结束时间,秒级时间戳。
同步的对局状态为对局结束时,该字段必传。
group_result_listList
对局结束时,阵型的结果数据
同步的对局状态为[已结束]时,该字段必传。
展开子属性
statusEnum
当前房间的游戏对局状态(1=已开始、2=已结束)
展开子属性
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/round/sync_status' \ --header 'content-type: application/json' \ --header 'X-Token: 0801121846735352506a356a6' \ --data '{ "round_id": 23, "room_id": "78273162632", "app_id": "tt411d37a0dxxxxx", "anchor_open_id": "UhJKbtCg3N", "start_time": 1722239345, "end_time": 1722239345, "status": 2, "group_result_list": [ { "group_id": "test-01", "result": 1 } ] }'
响应参数
Body
err_msg必填String
错误描述
err_no必填Int64
错误码,0代表成功
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0 }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40001 | 参数错误 | 请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配、请求头是否正确填写 |
200 | 4014034 | 请求过于频繁 | 接口有频控限制,建议降低请求的并发量 |
200 | 40004 | access_token过期 | 重新生成access_token,重新请求 |