将本轮结果保存到个人历史

POST

/sessions/{sessionId}/save

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

责任人：未设置

x-owner-module：data

需登录并提供同一浏览器匿名cookie（用于游客成绩转存）及CSRF。保存前端展示的当前轮次结果；必须提交 consent=true。重复保存同一轮次返回原记录，不增加第二条历史。

请求参数

Authorization

API Key

在 cookie 添加参数

SGSESSION

示例：

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

API Key

在 cookie 添加参数

SGGUEST

示例：

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

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "consent": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/sessions/22222222-2222-4222-8222-222222222222/save' \
--header 'X-CSRF-Token: demo_csrf_token_not_for_production_123456' \
--header 'Content-Type: application/json' \
--data '{
    "consent": true
}'

返回响应

🟢200成功（200）

application/json

本轮已加入当前账号的个人训练历史；同一用户重复调用返回同一记录。

Headers

Bodyapplication/json

示例

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

🟠401失败（401）

🟠403失败（403）

🟠404失败（404）

🟠409失败（409）

🟠410失败（410）

🟠413失败（413）

🟠415失败（415）

🟠422失败（422）

🔴500失败（500）

⚪default其他失败

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

记录本轮摄像头处理同意

创建游戏轮次