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

完成用户世界榜单的累计战绩上报

收藏
我的收藏

接口说明

当到达截榜时间且有线上生效的世界榜单版本时,在完成用户世界榜单的累计战绩上报后,调用本接口,标记本次截榜时间内的世界榜单累计战绩完成了上报。

基本信息

名称描述
HTTP URL
https://webcast.bytedance.com/api/gaming_con/world_rank/complete_upload_user_result
HTTP Method
POST
Scope
interactive_rank_config

请求参数

请求头
content-type必填String
固定值"application/json"
X-Token必填String
示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body
app_idString
玩法id
complete_timeInt64
上传完成时间
is_online_versionBool
是否是线上版本,默认为false,为false代表测试数据
world_rank_versionString
开发者指定上传到的榜单版本,如不传,则自动上传到当前生效版本空间
请求示例
curl --location --request POST '/api/gaming_con/world_rank/complete_upload_user_result' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"is_online_version":false,"complete_time":2519234890606564341,"app_id":"8Gipc1Cao8","world_rank_version":"rrVxpkURmX"}' # 此示例仅为模板,请修改为更加符合业务规则的调用示例,方便开发者查看

响应参数

响应示例
{ "err_no": 6020274037754047000, "err_msg": "dGZB8V1ZSG" }
切换单列布局

错误码

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