查询公开排行榜

GET

/leaderboards

最后修改时间：2026-10-25 08:52:00

责任人：未设置

x-owner-module：leaderboard

仅查询已经登录保存、明确选择公开、结算状态为completed的记录。按mode、levelCode、rulesVersion分组，每位用户只展示最佳成绩；同分按有效游戏时长升序，再按保存时间升序。响应不含username和userId。

请求参数

Authorization

API Key

在 cookie 添加参数

SGSESSION

示例：

SGSESSION: ********************

Query 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/leaderboards?mode=undefined&levelCode=undefined&rulesVersion=undefined&page=undefined&pageSize=undefined'

返回响应

🟢200

application/json

返回该玩法、关卡和规则版本下自愿公开用户的个人最佳成绩；仅支持小球和切水果。

Headers

Bodyapplication/json

示例

{
    "code": "OK",
    "message": "OK",
    "data": {
        "items": [
            {
                "displayNo": "选手001",
                "rank": 1,
                "mode": "balance_ball",
                "levelCode": "ball-standard-v1",
                "rulesVersion": "balance_ball-v2",
                "score": 100,
                "effectiveDurationMs": 60000,
                "savedAt": "2026-10-19T10:00:00Z"
            }
        ],
        "page": 1,
        "pageSize": 20,
        "total": 1
    }
}

🟠422

🔴500

⚪default

修改于 2026-10-25 08:52:00

提交八段锦游戏成绩

设置排行榜公开选择