接入说明

上报用户世界榜单的累计战绩，单次调用最多上报50个用户战绩。

本接口和【上传世界榜单列表数据】接口逻辑是不一样的。

•

【上传世界榜单列表数据】接口是一次性上传排好序的榜单Top 150的用户数据，数据直接展示在小摇杆的「世界榜」的榜单中，平台不做特殊处理，直接展示；底层是以榜单版本world_rank_version为维度存储，榜单版本world_rank_version维度重复上报，是覆盖写的逻辑；

•

本接口是上传所有参与玩法并且有战绩的用户数据，批量上报，底层是以用户id+榜单版本world_rank_version为维度存储，用户id+榜单版本world_rank_version维度重复上报，是覆盖写的逻辑；

【上传世界榜单列表数据】接口上传了榜单Top 150的用户数据
【上报用户世界榜单的累计战绩】接口依然需要再次上报Top 150的用户数据，同时也用于上报Top 150 以外的用户数据。

接口说明

上报用户世界榜单的累计战绩，单次调用最多上报50个用户战绩。

使用限制

小玩法app_id纬度，qps限流配置为 100/s。

基本信息

名称	描述
HTTP URL	https://webcast.bytedance.com/api/gaming_con/world_rank/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展开全部子属性

app_id必填String

玩法id

is_online_version必填Bool

是否是线上版本，默认为false，为false代表测试数据

user_list必填List

用户信息列表

展开子属性

world_rank_version必填String

开发者指定上传到的榜单版本，如不传，则自动上传到当前生效版本空间，命名不限，推荐使用当前时间戳

请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/world_rank/upload_user_result' \
--header 'content-type: application/json' \
--header 'X-Token: 0801121846735352506a356a6' \
--data '{"user_list":[{"score":101,"winning_streak_count":1,"rank":2704557422832063234,"open_id":"8P0gagOFad","winning_points":12}],"is_online_version":false,"app_id":"tt411d37a0dxxxx","world_rank_version":"1722239345"}'

响应参数

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，重新请求

上报用户世界榜单的累计战绩在线调试