开发者 API 文档 · maimai.imikufans.cn

简介

本站（maimai.imikufans.cn）对外提供舞萌DX 服务器状态查询接口，任何开发者均可免费调用。接口为 HTTP GET，返回 JSON，无需注册、无需申请 Key。

本站数据为聚合转发，仅供参考，不保证实时性与准确性，请勿用于商业决策或关键业务。

无需认证 JSON 跨域开放建议 30 秒/次

基础信息

Base URL

https://maimai.imikufans.cn/api.php

接口以该地址为前缀，通过 ?api= 参数区分具体功能。

请求方式

全部接口使用 GET，参数通过 URL Query String 传递。

响应格式

统一返回 Content-Type: application/json; charset=utf-8，UTF-8 编码。

调用频率

本站不主动限流，但数据源有保护机制。建议单客户端每 30 秒调用一次。短时间高频请求可能返回 502。

跨域

已开启 CORS 支持，浏览器前端可直接 fetch 调用，无需自建代理。

服务器状态实时

GET /api.php?api=status

获取舞萌DX 服务器当前运行状态，包含多个探针服务的健康度、延迟以及最近上报统计。数据每 30 秒更新一次。

请求参数

参数	类型	必填	说明
api	string	是	固定值 `status`

请求示例

curl "https://maimai.imikufans.cn/api.php?api=status"

const res = await fetch("https://maimai.imikufans.cn/api.php?api=status"); const data = await res.json(); console.log(data.verdict, data.services);

import requests r = requests.get("https://maimai.imikufans.cn/api.php", params={"api": "status"}) data = r.json() print(data["verdict"], data["services"])

<?php $json = file_get_contents("https://maimai.imikufans.cn/api.php?api=status"); $data = json_decode($json, true); echo $data["verdict"];

响应字段

字段	类型	说明
status	string	原始状态标识
verdict	string	总判定：`normal` / `degraded` / `recovering` / `outage` / `maintenance` / `nodata`
verdict_text	string	中文描述，可直接展示给用户
services[]	array	探针服务列表，每项含 `key`、`name`、`state`、`latency`、`duration_text`
latency.current_ms	number	当前平均延迟（毫秒）
latency.load_text	string	负载描述：低 / 中 / 高
reports.anomaly_count	number	近期异常上报数
reports.normal_count	number	近期正常上报数
broadcast.msg	string	公告文本，可能为空字符串

响应示例

{ "status": "normal", "verdict": "normal", "verdict_text": "一切正常", "services": [ { "key": "net", "name": "NET", "state": "ok", "latency": 42, "duration_text": "" }, { "key": "aime", "name": "会员", "state": "ok", "latency": 38, "duration_text": "" } ], "latency": { "current_ms": 42, "load_text": "低" }, "reports": { "anomaly_count": 3, "normal_count": 120 }, "broadcast": { "msg": "" } }

错误码

所有响应使用标准 HTTP 状态码。出现非 200 时，响应体为 JSON，含 error 字段。

状态码	含义	说明
200	成功	正常返回数据
400	参数错误	缺少 `api` 参数或值不在白名单内
502	上游异常	数据源暂时不可用，请稍后重试

错误响应示例

{ "error": "Invalid API" }

使用条款

1. 数据来源标注：使用本站接口时，请在显著位置标注数据来源，例如「数据来源于 maimai.imikufans.cn」。

2. 禁止滥用：请勿进行高频轮询、批量抓取或对本站造成负载压力。建议单客户端 30 秒一次。

3. 免责声明：本站为非官方平台，数据仅供参考，与华立科技及世嘉官方无任何关联。因使用本站数据造成的任何后果，本站不承担责任。

4. 变更：本站接口可能在不预先通知的情况下调整或下线，请在生产环境中做好容错处理。

反馈联系

接口异常、功能建议或合作事宜，欢迎通过以下方式联系：

站点：https://maimai.imikufans.cn

简介