上传世界榜单列表数据
收藏接入说明
设置正式环境/测试环境的世界榜单列表数据，榜单列表是指Top 150 的用户数据。如果接口调用的列表长度为 20，则表示榜单列表只展示Top 20的用户数据。
当到达定期更新世界榜单列表的时机时，调用一次，一次性上报世界榜单Top 150，如果调用第二次，第一次的数据会被覆盖，因为底层是以
榜单版本world_rank_version为维度存储，榜单版本world_rank_version维度重复上报，是覆盖写的逻辑；•比如：世界榜单更新逻辑是，每1分钟更新一次
◦8:00：调用【上传世界榜单列表数据】接口一次，一次性上报当前时刻的世界榜单Top 150；
◦8:01：调用【上传世界榜单列表数据】接口一次，一次性上报当前时刻的世界榜单Top 150，8:00上报的数据，将被8:01这次上报的覆盖；
建议 每 30s 调用一次，刷新最新的Top 150，保障榜单数据时效
接口说明
设置正式环境/测试环境的世界榜单列表数据
使用限制
小玩法app_id纬度，qps限流配置为 5/s。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://webcast.bytedance.com/api/gaming_con/world_rank/upload_rank_list |
| HTTP Method | POST |
| Scope | interactive_rank_config |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
X-Token必填String
示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body展开全部子属性
app_id必填String
玩法id
rank_list必填List
榜单用户列表
展开子属性
world_rank_version必填String
开发者指定上传到的榜单版本，如不传，则自动上传到当前生效版本空间
is_online_versionBool
是否是线上版本，默认为false，为false代表测试数据
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/world_rank/upload_rank_list' \ --header 'X-Token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \ --data '{"is_online_version":false,"app_id":"tt411d37a0dexxxx","world_rank_version":"1722239345","rank_list":[{"rank":12,"open_id":"HdGIJRpFG1","winning_points":100,"score":100,"winning_streak_count":2}]}'
响应参数
Body
err_msgString
错误描述
err_noInt64
错误码，0代表成功
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0 }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | 请求体中的必传参数是否都上传、请求的玩法id是否与请求时access_token相匹配、请求头是否正确填写等 |
| 200 | 4014034 | 请求过于频繁 | 接口有频控限制，建议降低请求的并发量 |
| 200 | 40004 | access_token过期 | 重新生成access_token，重新请求 |
