# 木鸡steadygame

## API Docs
- 根目录 > 01 账号与登录 [获取CSRF令牌](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508072e0.md): 登录前先调用，服务端设置匿名会话 Cookie。注册、登录和其他写操作在 X-CSRF-Token 请求头携带返回的 token。
- 根目录 > 01 账号与登录 [用户注册](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508073e0.md): 用户名不区分大小写唯一。密码确认由前端校验；接口只接收 username、password、nickname。注册成功不自动登录。
- 根目录 > 01 账号与登录 [用户登录](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508074e0.md): 先获取 CSRF。登录成功设置新的 SGSESSION Cookie 并返回新的 csrfToken，后续写操作使用新令牌。
- 根目录 > 01 账号与登录 [获取当前用户信息](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508075e0.md): 身份从当前会话取得，请求不需要也不接受 userId。不返回密码或哈希。
- 根目录 > 01 账号与登录 [退出登录](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508076e0.md): 失效当前会话。成功响应 data 为 null；退出后不能继续访问个人数据。
- 根目录 > 02 游戏目录 [获取游戏列表与规则](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508077e0.md): 返回三种玩法的 mode、规则版本、默认时长和必需关节点。游客可查看并创建试玩轮次。
- 根目录 > 03 游戏轮次与成绩 > 授权与结算 [记录本轮摄像头处理同意](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508081e0.md): 记录或撤回本轮本机摄像头处理同意。图像及关键点只在浏览器本机处理，不经本业务API上传；撤回后前端必须立即停止MediaStream和本地推理。此同意不代表用户同意保存成绩。
- 根目录 > 03 游戏轮次与成绩 > 授权与结算 [将本轮结果保存到个人历史](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508082e0.md): 需登录并提供同一浏览器匿名cookie（用于游客成绩转存）及CSRF。保存前端展示的当前轮次结果；必须提交 consent=true。重复保存同一轮次返回原记录，不增加第二条历史。
- 根目录 > 03 游戏轮次与成绩 [创建游戏轮次](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508078e0.md): 客户端先生成sessionId；服务端以该UUID作为训练会话主键和幂等依据。相同所有者和相同mode重试返回原轮次；同一ID用于不同mode返回409；其他身份碰撞统一404。匿名访客和登录用户均可创建。
- 根目录 > 03 游戏轮次与成绩 [获取游戏轮次详情](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508079e0.md): 查询当前创建者可访问的轮次。不存在、归属不匹配和已过期轮次统一返回404，避免泄露资源状态。
- 根目录 > 03 游戏轮次与成绩 [开始游戏](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508080e0.md): 校验当前轮次归属和本机摄像头处理同意后将created轮次切为active；重复调用已active轮次返回当前轮次，不重置startedAt或游戏状态；已结算轮次返回409 SESSION_STATE_CONFLICT。画面、校准、暂停/恢复、时钟、碰撞和本机姿态推理由前端完成。
- 根目录 > 05 运动记录与报告 [查询运动历史](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508083e0.md): 分页查询本人已结算记录，包含 completed 和 aborted。按 finishedAt、id 倒序；如按时间查询，from 与 to 必须同时提供，区间左闭右开，最多 366 天。 仅统计已显式保存到当前账号个人历史的结果；游客临时结果不会进入这些接口。
- 根目录 > 05 运动记录与报告 [查询运动数据统计](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508084e0.md): 只统计区间内结束且 completed 的轮次，按玩法分别给出均分。空数据平均分为 null，不将不同游戏原始分数混合平均。 仅统计已显式保存到当前账号个人历史的结果；游客临时结果不会进入这些接口。
- 根目录 > 05 运动记录与报告 [获取运动表现报告](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508085e0.md): 基于游戏记录汇总次数、时长和玩法表现。source 为 game_observation，medicalAssessment 为 false，不生成不存在的心率、血压或疾病诊断。 仅统计已显式保存到当前账号个人历史的结果；游客临时结果不会进入这些接口。
- 根目录 > 06 数据导出 [创建CSV或PDF导出任务](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508086e0.md): 为当前登录用户的已保存记录创建CSV/PDF导出任务。Idempotency-Key相同且请求相同则返回同一任务；key相同但请求体不同返回409。文件10分钟有效期从任务生成成功时起算，排队或失败状态expiresAt为null。
- 根目录 > 06 数据导出 [查询导出任务状态](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508087e0.md): 查询本人导出任务；任务行保留时expired作为状态返回。任务行清理后返回404；该接口不以410区分过期。
- 根目录 > 06 数据导出 [下载导出文件](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508088e0.md): 仅允许本人下载。成功为 CSV/PDF 文件流而非 JSON；文件名由 Content-Disposition 返回。任务未就绪返回 409，过期返回 410。
- 根目录 > 04 各游戏成绩提交 > 小球游戏 [提交小球游戏成绩](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508089e0.md): 提交 balance_ball（体感控制小球）本轮结算。请求体 mode、路由玩法和 sessionId 对应轮次的 mode 必须一致。轮次须已开始；时长为毫秒且不超过本轮配置。相同结果重试返回原结果，不同结果不覆盖。 score 必须等于 targetsHit×10，targetsHit不超过5。
- 根目录 > 04 各游戏成绩提交 > 切西瓜游戏 [提交切西瓜游戏成绩](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508090e0.md): 提交 watermelon_slice（体感切西瓜）本轮结算。请求体 mode、路由玩法和 sessionId 对应轮次的 mode 必须一致。轮次须已开始；时长为毫秒且不超过本轮配置。相同结果重试返回原结果，不同结果不覆盖。 score 必须等于 cutCount×10，combo不加分。
- 根目录 > 04 各游戏成绩提交 > 八段锦游戏 [提交八段锦游戏成绩](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508091e0.md): 提交浏览器本机姿态识别后的八段锦阶段完成情况。completedStageIds及completedStageCount由客户端报告；业务后端只校验两式、阶段值和计数关系，不接收或复核视频及关键点。完成8阶段时outcome=completed，否则为aborted；score固定null。
- 根目录 > 07 排行榜 [查询公开排行榜](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508092e0.md): 仅查询已经登录保存、明确选择公开、结算状态为completed的记录。按mode、levelCode、rulesVersion分组，每位用户只展示最佳成绩；同分按有效游戏时长升序，再按保存时间升序。响应不含username和userId。
- 根目录 > 07 排行榜 [设置排行榜公开选择](https://s.apifox.cn/a8edb76e-2ed2-410a-9257-ef06b51bcd22/528508093e0.md): 排行榜参与是可撤回的单独选择，不与摄像头或个人历史保存同意合并；默认不公开。