Place
2023年7月8日大约 8 分钟
根URL：
/place
GET getPlaceByName
getPlaceByName
子URI：
/{cityName}/{placeName}
根据地点名（或别名）（可模糊查找）获取地点信息（地点全称，更新时间，当前排卡数，是否更新过，地点公告）
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| placeId | Integer | 地点ID |
| placeName | String | 地点全称 |
| updateTime | Datetime | 更新时间 |
| cardCount | Integer | 当前排卡数 |
| updated | Boolean | 经每天初始化后是否再次更新过 |
| announcements | Array | 公告 |
| > announcementId | Long | 公告ID |
| > uploaderId | Long | 发布者QQ号 |
| > uploaderGroupId | Long | 发布者QQ群号 |
| > announcementContent | String | 公告内容 |
| > createTime | Datetime | 公告发布时间 |
| > expireTime | Datetime | 公告过期时间 |
Examples
200 OK: GET: /place/安徽省合肥市/风云
{
"code": 0,
"msg": "success",
"data": {
"placeId": 1,
"placeName": "风云再起淮河路店",
"updateTime": [
2023,
4,
4,
14,
2,
12
],
"cardCount": 6,
"updated": true,
"announcements": [
{
"announcementId": 1,
"uploaderId": 123456,
"uploaderGroupId": 12345678,
"announcementContent": "测试公告1",
"createTime": [
2023,
4,
4,
14,
2,
12
],
"expireTime": [
2023,
4,
11,
14,
2,
12
]
},
{
"announcementId": 2,
"uploaderId": 654321,
"uploaderGroupId": 123654321,
"announcementContent": "测试公告2",
"createTime": [
2023,
4,
4,
14,
5,
12
],
"expireTime": [
2023,
4,
11,
14,
2,
12
]
}
]
}
}
PUT updatePlaceByName
updatePlaceByName
子URI：
/{cityName}/{placeName}
根据地点名（或别名）（可模糊查找）更新卡数并登记在日志中。
注：当当前排卡数与操作数量的和小于0时，系统会将排卡数减至0而不是其他数字，日志中也会记录实际的操作数量。（如：当前排卡数为2，操作数量为-3，排卡数变为0，日志中记录更改数量为-2。）
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Body | qqId | Long | 是 | 更新者QQ号 |
| Body | qqGroupId | Long | 是 | 更新者发起更新所在的QQ群号 |
| Body | operateCount | Integer | 是 | 操作数量，不能为0 |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| placeId | Integer | 地点ID |
| placeName | String | 地点全称 |
| updateTime | Datetime | 更新时间 |
| cardCount | Integer | 当前排卡数 |
| updated | Boolean | 经每天初始化后是否再次更新过 |
| announcements | Array | 公告 |
| > announcementId | Long | 公告ID |
| > uploaderId | Long | 发布者QQ号 |
| > uploaderGroupId | Long | 发布者QQ群号 |
| > announcementContent | String | 公告内容 |
| > createTime | Datetime | 公告发布时间 |
| > expireTime | Datetime | 公告过期时间 |
Examples
200 OK: PUT: /place/安徽省合肥市/风云
{
"code": 0,
"msg": "success",
"data": {
"placeId": 1,
"placeName": "风云再起淮河路店",
"updateTime": [
2023,
4,
4,
14,
2,
12
],
"cardCount": 6,
"updated": true,
"announcements": [
{
"announcementId": 1,
"uploaderId": 123456,
"uploaderGroupId": 12345678,
"announcementContent": "测试公告1",
"createTime": [
2023,
4,
4,
14,
2,
12
],
"expireTime": [
2023,
4,
11,
14,
2,
12
]
},
{
"announcementId": 2,
"uploaderId": 654321,
"uploaderGroupId": 123654321,
"announcementContent": "测试公告2",
"createTime": [
2023,
4,
4,
14,
5,
12
],
"expireTime": [
2023,
4,
4,
14,
5,
12
]
}
]
}
}
PUT setPlaceByName
setPlaceByName
子URI：
/{cityName}/{placeName}/set
根据地点名（或别名）（可模糊查找）设置卡数并登记在日志中。
注：日志会记录实际的变更操作数，且当前后没有发生变化时，包括updateTime字段在内的日志与机厅信息均不会更新记录。（如：当前排卡数为2，要设置的数量为4，日志中记录更改数量为2。）
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Body | qqId | Long | 是 | 更新者QQ号 |
| Body | qqGroupId | Long | 是 | 更新者发起更新所在的QQ群号 |
| Body | operateCount | Integer | 是 | 要设置的数量，不能小于0 |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| placeId | Integer | 地点ID |
| placeName | String | 地点全称 |
| updateTime | Datetime | 更新时间 |
| cardCount | Integer | 当前排卡数 |
| updated | Boolean | 经每天初始化后是否再次更新过 |
| announcements | Array | 公告 |
| > announcementId | Long | 公告ID |
| > uploaderId | Long | 发布者QQ号 |
| > uploaderGroupId | Long | 发布者QQ群号 |
| > announcementContent | String | 公告内容 |
| > createTime | Datetime | 公告发布时间 |
| > expireTime | Datetime | 公告过期时间 |
Examples
200 OK: PUT: /place/安徽省合肥市/风云
{
"code": 0,
"msg": "success",
"data": {
"placeId": 1,
"placeName": "风云再起淮河路店",
"updateTime": [
2023,
4,
4,
14,
2,
12
],
"cardCount": 6,
"updated": true,
"announcements": [
{
"announcementId": 1,
"uploaderId": 123456,
"uploaderGroupId": 12345678,
"announcementContent": "测试公告1",
"createTime": [
2023,
4,
4,
14,
2,
12
],
"expireTime": [
2023,
4,
11,
14,
2,
12
]
},
{
"announcementId": 2,
"uploaderId": 654321,
"uploaderGroupId": 123654321,
"announcementContent": "测试公告2",
"createTime": [
2023,
4,
4,
14,
5,
12
],
"expireTime": [
2023,
4,
11,
14,
5,
12
]
}
]
}
}
GET getCityPlacesAscList
getCityPlacesAscList
子URI：
/list/{cityName}
将指定城市的自每日初始化后被更新过卡数的机厅的列表按照当前卡数的正序、更新时间的倒序返回。
注： 当自行实现 API 前端时，建议在调用本功能的地方为有公告的地点显示公告条数。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| total | Integer | 机厅数 |
| records | Array | 记录列表 |
| > placeName | String | 地点全称 |
| > updateTime | Datetime | 更新时间 |
| > cardCount | Integer | 当前排卡数 |
| > updated | Boolean | 经每天初始化后是否再次更新过 |
| > announcements | Array | 公告 |
| >> announcementId | Long | 公告ID（代表此地点有这个ID的公告） |
Examples
200 OK: GET: /place/list/安徽省合肥市
{
"code": 0,
"msg": "success",
"data": {
"total": 6,
"records": [
{
"placeId": 3,
"placeName": "天空之城合肥蜀山之心店",
"updateTime": [
2023,
4,
4,
14,
40,
36
],
"cardCount": 1,
"updated": true,
"announcements": []
},
{
"placeId": 7,
"placeName": "星世纪合肥唯品会店",
"updateTime": [
2023,
4,
4,
14,
24,
31
],
"cardCount": 2,
"updated": true,
"announcements": []
},
{
"placeId": 11,
"placeName": "星际传奇合肥高新店",
"updateTime": [
2023,
4,
4,
12,
37,
56
],
"cardCount": 2,
"updated": true,
"announcements": []
},
{
"placeId": 2,
"placeName": "super101合肥店",
"updateTime": [
2023,
4,
4,
13,
55,
14
],
"cardCount": 3,
"updated": true,
"announcements": [
{
"announcementId": 2
}
]
},
{
"placeId": 1,
"placeName": "风云再起淮河路店",
"updateTime": [
2023,
4,
4,
14,
2,
12
],
"cardCount": 6,
"updated": true,
"announcements": [
{
"announcementId": 1
}
]
},
{
"placeId": 5,
"placeName": "星奇多潮玩世界合肥正大广场店",
"updateTime": [
2023,
4,
4,
13,
25,
6
],
"cardCount": 8,
"updated": true,
"announcements": []
}
]
}
}
GET getSupportedPlaceNames
getSupportedPlaceNames
子URI：
/supported
获取所有本服务支持的城市及机厅。
Parameters
无
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| total | Integer | 城市数 |
| records | Array | 记录列表 |
| > cityName | String | 城市全名 |
| > placeNames | Array | 本服务已收录的该城市的所有机厅 |
Examples
200 OK: GET: /place/supported
{
"code": 0,
"msg": "success",
"data": {
"total": 10,
"records": [
{
"cityName": "上海市",
"placeNames": [
"风云再起上海店",
"大玩家上海宝山万达店",
"朗玩上海宝山区日月光店",
"风云再起上海2店",
"汤姆熊上海百联又一城店",
"上海joypolis世嘉都市乐园",
"风云再起上海长风大悦城店",
"风云再起上海中环百联店",
"汤姆熊上海环球港店",
"上海烈火游戏机娱乐有限公司",
"汤姆熊上海大悦城店",
"星乐荟上海浦东金汇广场店",
"风云再起上海长泰广场店",
"汤姆熊上海正大广场店",
"大玩家上海周浦万达店",
"汤姆熊上海旭辉广场店",
"汤姆熊上海浦东lalaport店",
"企萌电玩上海浦东店",
"星河部落川沙百联店",
"风云再起龙阳广场店",
"风云再起东郊百联店",
"天天玩上海徐汇汇银广场店",
"汤姆熊欢乐世界上海日月光店",
"风云再起上海维璟广场店",
"奇奇乐园上海店",
"大玩家上海闵行浦江万达店",
"星乐荟上海闽行华侨城店",
"大玩家马桥万达店",
"汤姆熊上海闽行南方店",
"汤姆熊上海长宁龙之梦店",
"聚玩堂上海龙之梦店",
"大玩家上海江桥万达店",
"风云再起上海嘉定百联店",
"大玩家上海崇明万达店",
"大玩家上海松江万达店",
"大玩家上海金山万达店",
"星际传奇瑞虹天地太阳宫店"
]
},
{
"cityName": "安徽省合肥市",
"placeNames": [
"风云再起淮河路店",
"super101合肥店",
"天空之城合肥蜀山之心店",
"星际传奇合肥蜀山万象城店",
"星奇多潮玩世界合肥正大广场店",
"大玩家合肥包河万达店",
"星世纪合肥唯品会店",
"星世纪合肥滨湖唯品会店",
"真快活合肥银泰城店",
"星际传奇合肥高新店",
"星际传奇合肥庐阳万科店",
"星潮电玩合肥新站店",
"潮玩世界合肥蜀山店",
"泛时空合肥庐阳店",
"城市星空合肥包河店"
]
},
{
"cityName": "安徽省宣城市",
"placeNames": [
"宣城酷卡贝家庭娱乐中心"
]
},
{
"cityName": "安徽省芜湖市",
"placeNames": [
"风云再起(苏宁广场)",
"真快活(银泰城)",
"明日世界(八佰伴)",
"天空之城(华强吾悦广场)"
]
},
{
"cityName": "安徽省蒙城县",
"placeNames": [
"卡希尔乐园(天河广场)"
]
},
{
"cityName": "安徽省阜阳市",
"placeNames": [
"颖泉城市玩家",
"太和星际之城"
]
},
{
"cityName": "山东省临沂市",
"placeNames": [
"乐游悦动临沂齐鲁吾悦店"
]
},
{
"cityName": "河北省秦皇岛市",
"placeNames": [
"大玩家秦皇岛万达店",
"风云再起秦皇岛店",
"多乐世界秦皇岛海港店"
]
},
{
"cityName": "甘肃省兰州市",
"placeNames": [
"PPG潮玩汇（东方红广场）",
"大玩家（万达广场）",
"奥德乐（奥特莱斯）",
"风云再起（国芳百货）",
"天空之城（吾悦广场）",
"星际传奇（万象城）",
"酷玩时代（欣大百货）",
"斯跑曼（万达茂）"
]
},
{
"cityName": "福建省莆田市",
"placeNames": [
"大玩家莆田城厢万达店",
"大玩家莆田秀屿万达店",
"蓝鲸乐园莆田仙游店"
]
}
]
}
}