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