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

查询运动历史

GET
/records
最后修改时间:2026-10-25 08:52:00
责任人:未设置
x-owner-module:data
分页查询本人已结算记录,包含 completed 和 aborted。按 finishedAt、id 倒序;如按时间查询,from 与 to 必须同时提供,区间左闭右开,最多 366 天。 仅统计已显式保存到当前账号个人历史的结果;游客临时结果不会进入这些接口。

请求参数

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

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/records?from=2026-10-01T00%3A00%3A00Z&to=2026-11-01T00%3A00%3A00Z&mode=balance_ball&page=1&pageSize=20'

返回响应

🟢200成功(200)
application/json
查询本人已结算记录;结束时间倒序,再按 ID 倒序
Headers

Bodyapplication/json

示例
{
    "code": "OK",
    "message": "OK",
    "data": {
        "items": [
            {
                "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": "completed",
                "createdAt": "2026-10-11T10:00:00Z",
                "startedAt": "2026-10-11T10:00:00Z",
                "finishedAt": "2026-10-11T10:00:00Z",
                "result": {
                    "id": "22222222-2222-4222-8222-222222222222",
                    "sessionId": "22222222-2222-4222-8222-222222222222",
                    "userId": "11111111-1111-4111-8111-111111111111",
                    "submittedAt": "2026-10-11T10:00:00Z",
                    "source": "client_reported",
                    "payload": {
                        "mode": "balance_ball",
                        "outcome": "completed",
                        "score": 50,
                        "activeDurationMs": 60000,
                        "trackingDurationMs": 9000,
                        "metrics": {
                            "targetsHit": 5,
                            "collisions": 1,
                            "reachedEnd": false
                        }
                    },
                    "savedToHistory": true,
                    "savedAt": "2026-10-11T10:01:00Z"
                },
                "ownerType": "account",
                "savedToHistory": true,
                "expiresAt": null
            }
        ],
        "page": 1,
        "pageSize": 20,
        "total": 1
    }
}
🟠401失败(401)
🟠422失败(422)
🔴500失败(500)
⚪default其他失败
修改于 2026-10-25 08:52:00
上一页
开始游戏
下一页
查询运动数据统计
Built with