1. 03 游戏轮次与成绩
木鸡steadygame
  • 木鸡SteadyGame API接口
    • 01 账号与登录
      • 获取CSRF令牌
      • 用户注册
      • 用户登录
      • 获取当前用户信息
      • 退出登录
    • 02 游戏目录
      • 获取游戏列表与规则
    • 03 游戏轮次与成绩
      • 授权与结算
        • 记录本轮摄像头处理同意
        • 将本轮结果保存到个人历史
      • 创建游戏轮次
        POST
      • 获取游戏轮次详情
        GET
      • 开始游戏
        POST
    • 05 运动记录与报告
      • 查询运动历史
      • 查询运动数据统计
      • 获取运动表现报告
    • 06 数据导出
      • 创建CSV或PDF导出任务
      • 查询导出任务状态
      • 下载导出文件
    • 04 各游戏成绩提交
      • 小球游戏
        • 提交小球游戏成绩
      • 切西瓜游戏
        • 提交切西瓜游戏成绩
      • 八段锦游戏
        • 提交八段锦游戏成绩
    • 07 排行榜
      • 查询公开排行榜
      • 设置排行榜公开选择
  1. 03 游戏轮次与成绩

创建游戏轮次

POST
/sessions
最后修改时间:2026-10-26 14:43:02
责任人:未设置
x-owner-module:data
客户端先生成sessionId;服务端以该UUID作为训练会话主键和幂等依据。相同所有者和相同mode重试返回原轮次;同一ID用于不同mode返回409;其他身份碰撞统一404。匿名访客和登录用户均可创建。

请求参数

Authorization
API Key
在 cookie 添加参数
SGSESSION
示例:
SGSESSION: ********************
or
API Key
在 cookie 添加参数
SGGUEST
示例:
SGGUEST: ********************
or
Header 参数

Body 参数application/json必填

示例
{
    "mode": "balance_ball",
    "sessionId": "0f671fc0-7b3d-43d3-a789-f90d1f4f8c22"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/sessions' \
--header 'X-CSRF-Token: KW9x8sui2wTi9hD0QLyZUQTJHjwcqdt7_NwW3CQ5QYo' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "balance_ball",
    "sessionId": "0f671fc0-7b3d-43d3-a789-f90d1f4f8c22"
}'

返回响应

🟢201成功(201)
application/json
幂等创建游戏轮次;重试复用 sessionId
Headers

Bodyapplication/json

示例
{
    "code": "OK",
    "message": "OK",
    "data": {
        "id": "22222222-2222-4222-8222-222222222222",
        "userId": "11111111-1111-4111-8111-111111111111",
        "mode": "balance_ball",
        "config": {
            "mode": "balance_ball",
            "durationMs": 60000,
            "targetCount": 5,
            "pointsPerTarget": 10,
            "trackBounds": {
                "leftXRatio": 0.08,
                "rightXRatio": 0.92
            },
            "targets": [
                {
                    "id": "target-1",
                    "spawnAtMs": 0,
                    "xRatio": 0.22,
                    "yRatio": 0.3,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-2",
                    "spawnAtMs": 10000,
                    "xRatio": 0.38,
                    "yRatio": 0.48,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-3",
                    "spawnAtMs": 20000,
                    "xRatio": 0.55,
                    "yRatio": 0.32,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-4",
                    "spawnAtMs": 30000,
                    "xRatio": 0.7,
                    "yRatio": 0.5,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                },
                {
                    "id": "target-5",
                    "spawnAtMs": 40000,
                    "xRatio": 0.82,
                    "yRatio": 0.34,
                    "velocityXRatioPerSecond": 0,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.045
                }
            ],
            "obstacles": [
                {
                    "id": "obstacle-1",
                    "spawnAtMs": 0,
                    "xRatio": 0.48,
                    "yRatio": 0.62,
                    "velocityXRatioPerSecond": 0.12,
                    "velocityYRatioPerSecond": 0,
                    "radiusRatio": 0.055
                }
            ],
            "levelCode": "ball-standard-v1",
            "finishLineXRatio": 0.9,
            "completionBonus": 50
        },
        "rulesVersion": "balance_ball-v1",
        "status": "created",
        "createdAt": "2026-10-11T10:00:00Z",
        "startedAt": null,
        "finishedAt": null,
        "result": null,
        "ownerType": "account",
        "savedToHistory": false,
        "expiresAt": "2026-10-12T10:00:00Z"
    }
}
🟠401失败(401)
🟠403失败(403)
🟠409失败(409)
🟠413失败(413)
🟠415失败(415)
🟠422失败(422)
🟠429
🔴500失败(500)
⚪default其他失败
修改于 2026-10-26 14:43:02
上一页
将本轮结果保存到个人历史
下一页
获取游戏轮次详情
Built with