MaiJ - 接口

本服务所有接口的根URL均为

https://api.hammer-hfut.tk:233/maij

本服务的所有接口如下，其中响应举例中的QQ号、QQ群号等信息皆为脸滚键盘生成，如有雷同纯属巧合

⚠️注意事项

本服务中所有响应体都统一包装为如下的格式

{
   "code": integer,
   "msg": string,
   "data": object
}

其中code为响应码，msg为响应信息，data为响应数据，在后文的API文档中有关响应数据的说明中，将只对"data"部分进行说明

本服务采用Jackson提供的JSR310库中的序列化器与反序列化器为日期、时间型数据进行序列化和反序列化，因此本服务中的所有日期、时间型数据的格式均为类似于如下的格式

"time": [
   2022,
   7,
   19,
   2,
   15
]

其中time为一个整数型列表，从下标0开始到更高分别为：年、月、日、时、分、秒，若秒为0则列表中无秒项（如上例）

本服务中所有“准确省市全称”字段必须为准确无误的省市全称，例："安徽省合肥市"，"安徽省芜湖市"，"天津市"（在参数中不需要添加引号）

（虽然还不支持天津市的机厅

本服务中所有“模糊地点名/别名”字段均表示会对地点全称以及地点别名进行先后进行精确查询与模糊查询直到找到匹配项，地点全称的优先级高于别名的优先级；当模糊查询到一个名称对应多个地点时，将返回“指定参数对应多个结果”异常^1。例子如下：

• 在"安徽省芜湖市"查询"芜"，返回"风云再起安徽芜湖店"，即使"风云再起安徽芜湖店"的别名中没有"芜"
• 在"安徽省宣城市"查询"k"，返回"宣城酷卡贝家庭娱乐中心"，即使"宣城酷卡贝家庭娱乐中心"的别名只有"kkb"
• 在"安徽省合肥市"查询"星"，返回“指定参数对应多个结果”异常^1

API列表

Place

机厅当前卡数查询以及更新的接口

Log

有关卡数更新日志的接口

Alias

有关机厅别名的接口

Announcement

有关机厅公告的接口