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

提交八段锦游戏成绩

PUT
/games/baduanjin/sessions/{sessionId}/result
最后修改时间:2026-10-25 08:52:00
责任人:未设置
x-owner-module:baduanjin
提交浏览器本机姿态识别后的八段锦阶段完成情况。completedStageIds及completedStageCount由客户端报告;业务后端只校验两式、阶段值和计数关系,不接收或复核视频及关键点。完成8阶段时outcome=completed,否则为aborted;score固定null。

请求参数

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

Header 参数

Body 参数application/json必填

示例
{
    "mode": "baduanjin",
    "outcome": "completed",
    "score": null,
    "activeDurationMs": 120000,
    "trackingDurationMs": 110000,
    "metrics": {
        "attempts": [
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "ready",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "raise",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.5,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "hold",
                "side": "both",
                "completed": true,
                "holdDurationSec": 1.5,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "recover",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "ready",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "raise",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.5,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "hold",
                "side": "left",
                "completed": true,
                "holdDurationSec": 1.5,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "recover",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            }
        ],
        "actions": [
            {
                "actionCode": "tuotian",
                "leftCount": 1,
                "rightCount": 1,
                "completeCycles": 1
            },
            {
                "actionCode": "danju",
                "leftCount": 1,
                "rightCount": 0,
                "completeCycles": 1
            }
        ]
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT '/games/baduanjin/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": "baduanjin",
    "outcome": "completed",
    "score": null,
    "activeDurationMs": 120000,
    "trackingDurationMs": 110000,
    "metrics": {
        "attempts": [
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "ready",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "raise",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.5,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "hold",
                "side": "both",
                "completed": true,
                "holdDurationSec": 1.5,
                "rejectionReason": null
            },
            {
                "actionCode": "tuotian",
                "ruleVersion": "v1",
                "stage": "recover",
                "side": "both",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "ready",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "raise",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.5,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "hold",
                "side": "left",
                "completed": true,
                "holdDurationSec": 1.5,
                "rejectionReason": null
            },
            {
                "actionCode": "danju",
                "ruleVersion": "v1",
                "stage": "recover",
                "side": "left",
                "completed": true,
                "holdDurationSec": 0.8,
                "rejectionReason": null
            }
        ],
        "actions": [
            {
                "actionCode": "tuotian",
                "leftCount": 1,
                "rightCount": 1,
                "completeCycles": 1
            },
            {
                "actionCode": "danju",
                "leftCount": 1,
                "rightCount": 0,
                "completeCycles": 1
            }
        ]
    }
}'

返回响应

🟢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": "baduanjin",
            "outcome": "completed",
            "score": null,
            "activeDurationMs": 120000,
            "trackingDurationMs": 110000,
            "metrics": {
                "attempts": [
                    {
                        "actionCode": "tuotian",
                        "ruleVersion": "v1",
                        "stage": "ready",
                        "side": "both",
                        "completed": true,
                        "holdDurationSec": 0.8,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "tuotian",
                        "ruleVersion": "v1",
                        "stage": "raise",
                        "side": "both",
                        "completed": true,
                        "holdDurationSec": 0.5,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "tuotian",
                        "ruleVersion": "v1",
                        "stage": "hold",
                        "side": "both",
                        "completed": true,
                        "holdDurationSec": 1.5,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "tuotian",
                        "ruleVersion": "v1",
                        "stage": "recover",
                        "side": "both",
                        "completed": true,
                        "holdDurationSec": 0.8,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "danju",
                        "ruleVersion": "v1",
                        "stage": "ready",
                        "side": "left",
                        "completed": true,
                        "holdDurationSec": 0.8,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "danju",
                        "ruleVersion": "v1",
                        "stage": "raise",
                        "side": "left",
                        "completed": true,
                        "holdDurationSec": 0.5,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "danju",
                        "ruleVersion": "v1",
                        "stage": "hold",
                        "side": "left",
                        "completed": true,
                        "holdDurationSec": 1.5,
                        "rejectionReason": null
                    },
                    {
                        "actionCode": "danju",
                        "ruleVersion": "v1",
                        "stage": "recover",
                        "side": "left",
                        "completed": true,
                        "holdDurationSec": 0.8,
                        "rejectionReason": null
                    }
                ],
                "actions": [
                    {
                        "actionCode": "tuotian",
                        "leftCount": 1,
                        "rightCount": 1,
                        "completeCycles": 1
                    },
                    {
                        "actionCode": "danju",
                        "leftCount": 1,
                        "rightCount": 0,
                        "completeCycles": 1
                    }
                ]
            }
        },
        "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
上一页
提交切西瓜游戏成绩
下一页
查询公开排行榜
Built with