API 目前处于 Early Preview 阶段， 可能存在诸多不完善与错误之处，欢迎加群交流反馈：加入官方交流群（1073434398）
API 参考
v1 游戏数据面的完整 schema：能力矩阵、游戏格式、档案、成绩与最佳成绩。每个端点都可直接试调。
这里的每一页都由 OpenAPI schema 渲染（openapi/rankhub-v1-games.json）：请求体字段、取值范围、
响应结构与错误码与代码同源。右上角可以在页面上直接改 body 发请求。
能力矩阵
10 个游戏在你这个应用下实际可用的能力（读 / 建档 / 推成绩 / 删除申请）。
游戏格式
GET /v1/games/{game}/format：身份字段、统一字段、source 原生字段、评分体系与桶规则。
档案
建档（POST …/profiles）、读取单个档案、列档案；身份字段逐游戏不同。
成绩
推成绩（批量写入）、读成绩（游标分页）、最佳成绩（统一桶形状）。
与「开发手册」的分工
| 你想要 | 去哪 |
|---|---|
| 理解为什么这样设计（三层模型、字段归一、桶） | 开发手册 · 设计概念 |
| 看每个游戏的身份字段、原生字段、评分口径 | 开发手册 · 统一结构 与 各游戏细节 |
| 抄一份请求体 / 核对某个字段的类型与范围 | 本页左侧四组端点 |
