---
url: https://wiki.awmc.team/dev.md
---

# 💻 开发者中心

## 📊 Status API  (原基准地址: `https://status.awmc.cc`)

::: danger ⚠️ 该接口已废弃 (Deprecated)
AWMC 已停止提供状态 API，接口不再维护，请勿接入。舞萌服务器状态数据可参考社区项目 [mai.chongxi.us](https://mai.chongxi.us/)（与 AWMC 无任何关联）。
:::

::: info 💡 服务概述
实时监控 AWMC 所提供的舞萌服务的运行状态（历史存档）。
:::

* **鉴权方式**： (对所有用户公开)
* **访问限制**：`10 QPS` (每秒查询率)
* **详细文档**：[点击查看 Status API 详情](/dev/status-api)

## 🔌 AWMC 公共 API (基准地址: `https://api.wmc.pub`)

::: info 💡 业务接口
提供用户数据 / 谱面查询、发票充值与队列、成绩上传（水鱼 / 落雪）等业务接口（新版 `/v1/user/*`、`/v1/charge` 等）。
:::

* **鉴权方式**： (需在 Authorization 中携带)
* **消耗规则**：HTTP 成功且上游业务成功时扣 Token（普通接口 `returnCode===1`，health/ping 为 `0`）。对外路径尽量兼容旧 `/v1/*`。
* **详细文档**：[点击查看 AWMC 公共 API 详情](/dev/awmc-api)

## 🗂️ AWMCNET Bot API (基准地址: `https://net.wmc.pub`)

::: info 💡 成绩镜像与查询
面向 QueryBot 和查分器的成绩同步接口，支持同一个 `snapshot_id` 分块提交全量快照，
适合避免大成绩包一次性请求超时。
:::

* **鉴权方式**：
* **主要接口**：`POST /api/bot/sync`、`GET /api/bot/player/{qq}`
* **详细文档**：[点击查看 AWMCNET Bot API 详情](/dev/awmcnet-api)

## 🖼️ Assets 静态资源 API (基准地址: `https://download.wmc.pub`)

::: info 💡 静态资源
通过 download.wmc.pub 统一获取曲绘封面、谱面索引、单曲原始文件与打包；旧资源域名及 `/covers/:id` 不再作为接入方式。
:::

* **鉴权方式**： (公开访问)
* **资源类型**：曲绘图片（格式以 `Content-Type` 为准）、谱面文本、音源、PV 与单曲包；批量包仍需人机验证。
* **详细文档**：[点击查看 Assets 静态资源 API 详情](/dev/assets-api)

## 🎵 谱面预览 (入口: `https://v.awmc.cc`)

::: info 💡 浏览器预览
在网页中查看舞萌谱面；参数与落雪乐曲 ID、谱面类型及难度档位对应，适合开发与分享链接。
:::

* **鉴权方式**： (公开访问)
* **详细文档**：[点击查看谱面预览说明](/dev/chart-preview)

## 📊 谱面评价与分析 API (基准地址: `https://v.wmc.pub/api/v1/`)

::: info 💡 REST API
谱面预览平台的公开 REST API，支持谱面查询、评论、评分、成绩提交、排行榜等功能。需要 API Key 鉴权。
:::

* **鉴权方式**： (需在 Authorization 中携带)
* **详细文档**：[点击查看谱面评价与分析 API 详情](/dev/chart-preview-api)

## 🚀 快速上手

你可以通过以下链接快速访问不同模块的开发文档：

* [**舞萌状态 API**](/dev/status-api) - （已废弃）原用于获取服务实时在线状态、心跳记录及公告。
* [**AWMC 公共 API**](/dev/awmc-api) - 用户查询、发票充值队列、成绩上传（水鱼 / 落雪）。
* [**AWMCNET Bot API**](/dev/awmcnet-api) - 成绩镜像、玩家查询与分块快照同步。
* [**Assets 静态资源 API**](/dev/assets-api) - 曲绘、资源图库等静态文件获取。
* [**谱面预览**](/dev/chart-preview) - 浏览器内谱面预览与 Query 参数说明。
* [**谱面评价与分析 API**](/dev/chart-preview-api) - 谱面查询、评论、评分、成绩提交与排行榜 REST API。
* \[**更多功能**] - 正在开发中，敬请期待...

::: tip 建议
如果你在开发过程中遇到任何问题，欢迎通过 [GitHub](https://github.com/Michaelwucoc/awmc-wiki) 提交 Issue 或联系我们的团队。

也欢迎加入开发者交流群：[1067350296](https://qm.qq.com/q/TJUgWpUAcS)，一起聊接口、排坑和协作。
:::