💻 开发者中心
欢迎来到 AWMC 开发者中心。我们为开发者提供了多种接口和工具，帮助你构建属于自己的舞萌应用或集成服务。
📊 Status API (基准地址: https://status.awmc.cc)
💡 服务概述
实时监控 AWMC 所提供的舞萌服务的运行状态。
- 鉴权方式：无需鉴权 (对所有用户公开)
- 访问限制：
10 QPS(每秒查询率) - 详细文档：点击查看 Status API 详情
🔌 AWMC 公共 API (基准地址: https://api.wmc.pub)
💡 业务接口
提供用户数据 / 谱面查询、发票充值与队列、成绩上传（水鱼 / 落雪）等业务接口（新版 /v1/user/*、/v1/charge 等）。
- 鉴权方式：Bearer 令牌 (需在 Authorization 中携带)
- 消耗规则：HTTP 成功且上游业务成功时扣 Token（普通接口
returnCode===1，health/ping 为0）。对外路径尽量兼容旧/v1/*。 - 详细文档：点击查看 AWMC 公共 API 详情
🗂️ AWMCNET Bot API (基准地址: https://net.wmc.pub)
💡 成绩镜像与查询
面向 QueryBot 和查分器的成绩同步接口，支持同一个 snapshot_id 分块提交全量快照， 适合避免大成绩包一次性请求超时。
- 鉴权方式：Bot-Token
- 主要接口：
POST /api/bot/sync、GET /api/bot/player/{qq} - 详细文档：点击查看 AWMCNET Bot API 详情
🖼️ Assets 静态资源 API (基准地址: https://assets.awmc.cc)
💡 静态资源
提供了曲绘、UI 元素等游戏相关的高清静态资源，方便在您的应用中展示。
- 鉴权方式：无需鉴权 (公开访问)
- 资源类型：
.png格式的曲绘图。 - 详细文档：点击查看 Assets 静态资源 API 详情
🎵 谱面预览 (入口: https://v.awmc.cc)
💡 浏览器预览
在网页中查看舞萌谱面；参数与落雪乐曲 ID、谱面类型及难度档位对应，适合开发与分享链接。
- 鉴权方式：无需鉴权 (公开访问)
- 详细文档：点击查看谱面预览说明
📊 谱面评价与分析 API (基准地址: https://v.wmc.pub/api/v1/)
💡 REST API
谱面预览平台的公开 REST API，支持谱面查询、评论、评分、成绩提交、排行榜等功能。需要 API Key 鉴权。
- 鉴权方式：Bearer API Key (需在 Authorization 中携带)
- 详细文档：点击查看谱面评价与分析 API 详情
🚀 快速上手
你可以通过以下链接快速访问不同模块的开发文档：
- 舞萌状态 API - 获取服务实时在线状态、心跳记录及公告。
- AWMC 公共 API - 用户查询、发票充值队列、成绩上传（水鱼 / 落雪）。
- AWMCNET Bot API - 成绩镜像、玩家查询与分块快照同步。
- Assets 静态资源 API - 曲绘、资源图库等静态文件获取。
- 谱面预览 - 浏览器内谱面预览与 Query 参数说明。
- 谱面评价与分析 API - 谱面查询、评论、评分、成绩提交与排行榜 REST API。
- [更多功能] - 正在开发中，敬请期待...
建议
如果你在开发过程中遇到任何问题，欢迎通过 GitHub 提交 Issue 或联系我们的团队。