提交小球游戏成绩

PUT

/games/balance_ball/sessions/{sessionId}/result

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

责任人：未设置

x-owner-module：balance_ball

提交 balance_ball（体感控制小球）本轮结算。请求体 mode、路由玩法和 sessionId 对应轮次的 mode 必须一致。轮次须已开始；时长为毫秒且不超过本轮配置。相同结果重试返回原结果，不同结果不覆盖。 score 必须等于 targetsHit×10，targetsHit不超过5。

请求参数

Authorization

API Key

在 cookie 添加参数

SGSESSION

示例：

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

API Key

在 cookie 添加参数

SGGUEST

示例：

SGGUEST: ********************

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "mode": "balance_ball",
    "outcome": "completed",
    "score": 50,
    "activeDurationMs": 60000,
    "trackingDurationMs": 58000,
    "metrics": {
        "targetsHit": 5,
        "collisions": 1,
        "reachedEnd": false
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT '/games/balance_ball/sessions/22222222-2222-4222-8222-222222222222/result' \
--header 'X-CSRF-Token: demo_csrf_token_not_for_production_123456' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "balance_ball",
    "outcome": "completed",
    "score": 50,
    "activeDurationMs": 60000,
    "trackingDurationMs": 58000,
    "metrics": {
        "targetsHit": 5,
        "collisions": 1,
        "reachedEnd": false
    }
}'

返回响应

🟢200成功（200）

application/json

结果暂存于当前轮次并返回给结果页；不写入个人历史。保存需另行调用 POST /sessions/{sessionId}/save。

Headers

Bodyapplication/json

示例

{
    "code": "OK",
    "message": "OK",
    "data": {
        "id": "22222222-2222-4222-8222-222222222222",
        "sessionId": "22222222-2222-4222-8222-222222222222",
        "userId": null,
        "submittedAt": "2026-10-11T10:00:00Z",
        "source": "client_reported",
        "payload": {
            "mode": "balance_ball",
            "outcome": "completed",
            "score": 50,
            "activeDurationMs": 60000,
            "trackingDurationMs": 58000,
            "metrics": {
                "targetsHit": 5,
                "collisions": 1,
                "reachedEnd": false
            }
        },
        "savedToHistory": false,
        "savedAt": null
    }
}

🟠401失败（401）

🟠403失败（403）

🟠404失败（404）

🟠409失败（409）

🟠413失败（413）

🟠415失败（415）

🟠422失败（422）

🔴500失败（500）

⚪default其他失败

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

下载导出文件

提交切西瓜游戏成绩