MaiJ - 接口
大约 2 分钟
本服务所有接口的根 URL 均为
https://api.argonariod.tech/maij
本服务的所有接口如下，其中响应举例中的 QQ 号、QQ 群号等信息皆为脸滚键盘生成，如有雷同纯属巧合。
⚠️注意事项
MaiJ API Token
本服务所提供的 所有 接口都要求客户端在请求中附上如下的请求头：
| 请求头名 | 数据类型 | 说明 |
|---|---|---|
| X-MaiJ-Token | String | 你所申请到的有效的 MaiJ API Token |
否则服务端将会返回“未认证”异常^1。
时间格式
本服务采用无时区、精度为秒的 ISO 8601 标准时间格式返回时间，如 "2026-03-28T16:17:00" 表示 2026 年 3 月 28 日 16 时 17 分 0 秒。时区默认为 UTC+8（东八区）。
省市全称
本服务中所有“准确省市全称”字段必须为准确无误的省市全称，例：安徽省合肥市、安徽省芜湖市、上海市。
机厅名称查询
本服务中所有“模糊地点名/别名”字段均表示会对地点全称以及地点别名进行以下的查询操作：
假设用户查询的名称字面量为 “str”，目标查询城市为 “西京市”，存在 “西京市” 这个城市，并且用户的 MaiJ API Token 拥有对 “西京市” 的地点查询权限：
- 查询西京市所有全名为 “str” 的机厅，如果有且仅有一个则返回该机厅；
- 查询西京市所有别名为 “str” 的机厅，如果有且仅有一个则返回该机厅；
- 查询西京市所有全名中包含 “str” 的机厅，如果有且仅有一个则返回该机厅；
- 返回“未找到结果”异常^2。
当在上述的任何一级查询到一个名称对应多个地点时，将直接返回“指定参数对应多个结果”异常^3。
游戏名称查询
gameName 查询参数支持按游戏名和游戏别名匹配。
例如：
mai会匹配默认游戏“舞萌”chu、chuni、中二会匹配“中二节奏”