💻 开发者中心
欢迎来到 AWMC 开发者中心。我们为开发者提供了多种接口和工具，帮助你构建属于自己的舞萌应用或集成服务。
📊 Status API 已废弃 (原基准地址: https://status.awmc.cc)
⚠️ 该接口已废弃 (Deprecated)
AWMC 已停止提供状态 API，接口不再维护，请勿接入。舞萌服务器状态数据可参考社区项目 mai.chongxi.us（与 AWMC 无任何关联）。
💡 服务概述
实时监控 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://download.wmc.pub)
💡 静态资源
通过 download.wmc.pub 统一获取曲绘封面、谱面索引、单曲原始文件与打包；旧资源域名及 /covers/:id 不再作为接入方式。
- 鉴权方式：无需鉴权 (公开访问)
- 资源类型：曲绘图片（格式以
Content-Type为准）、谱面文本、音源、PV 与单曲包；批量包仍需人机验证。 - 详细文档：点击查看 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。
- [更多功能] - 正在开发中，敬请期待...