城市
大约 4 分钟
根 URL：
/city
GET 查询所有支持城市列表
查询所有支持城市列表
子 URI：
获取本服务所有支持的城市的列表。
Parameters
Responses
本接口的响应本身是一个 JSON 列表。
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| > id | Long | 城市 ID |
| > name | String | 城市名 |
Examples
200 OK: GET: /city
[
{
"id": 20,
"name": "上海市"
},
{
"id": 1,
"name": "安徽省合肥市"
}
]
GET查询指定城市的卡数更新情况
GET查询指定城市的卡数更新情况
查询指定城市的卡数更新情况
子 URI：
/{cityName}/card
查询指定城市的所有已更新地点的卡数和公告数，以及所有未更新卡数但存在公告的地点，并按卡数的正序、更新时间的倒序返回。默认情况下会返回所有游戏的总卡数与分游戏卡数；也支持按多个游戏过滤。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Query | gameName | Array of String | 否 | 按游戏名或游戏别名过滤，支持多值 |
规则说明：
- 不传
gameName时：cardCount为所有游戏卡数总和placeGames返回所有游戏的分卡数
- 传
gameName时：cardCount为被选中游戏的总和placeGames只返回被选中的游戏项
Responses
本接口的响应会受到 Gzip 压缩。
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| updatedPlaces | Array | 已更新地点 |
| nonUpdatedPlacesWithAnnouncements | Array | 未更新但存在公告的地点 |
其中每个地点元素为 Place，并额外包含 placeGames：
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| > id | Integer | 地点 ID |
| > name | String | 地点全称 |
| > updateTime | Datetime | 更新时间 |
| > cardCount | Integer | 当前总排卡数或过滤后的总卡数 |
| > isUpdated | Boolean | 是否再次更新过 |
| > announcements | Array | 公告 |
| >> id | Long | 公告 ID |
| > placeGames | Array | 分游戏卡数 |
| >> id | Long | 地点-游戏关联 ID |
| >> game | Object | 游戏信息 |
| >>> id | Long | 游戏 ID |
| >>> name | String | 游戏名 |
| >>> order | Integer | 游戏顺序 |
| >> cardCount | Integer | 该游戏排卡数 |
Examples
200 OK: GET: /city/天界区域/card
{
"updatedPlaces": [
{
"id": 345,
"name": "风云再起天界区域店2",
"updateTime": "2026-03-29T16:46:08",
"cardCount": 5,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 6,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 4
},
{
"id": 4,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 1
}
]
},
{
"id": 344,
"name": "风云再起天界区域店",
"updateTime": "2026-03-29T16:46:06",
"cardCount": 6,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 1,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 2
},
{
"id": 3,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 4
}
]
},
{
"id": 343,
"name": "super101天界区域店",
"updateTime": "2026-03-29T16:46:11",
"cardCount": 7,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 5,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 1
},
{
"id": 2,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 6
}
]
}
],
"nonUpdatedPlacesWithAnnouncements": []
}
200 OK: GET: /city/天界区域/card?gameName=mai
{
"updatedPlaces": [
{
"id": 12,
"name": "星际传奇合肥庐阳万科店",
"updateTime": "2024-03-10T15:34:52",
"cardCount": 2,
"announcements": []
},
{
"id": 189,
"name": "萌宝熊合肥悦方店",
"updateTime": "2024-03-10T15:12:10",
"cardCount": 2,
"announcements": []
},
{
"id": 114,
"name": "泛时空合肥庐阳店",
"updateTime": "2024-03-10T13:23:54",
"cardCount": 2,
"announcements": []
},
{
"id": 5,
"name": "星奇多潮玩世界合肥正大广场店",
"updateTime": "2024-03-10T16:03:41",
"cardCount": 3,
"announcements": []
},
{
"id": 198,
"name": "星奇多漫乐城店",
"updateTime": "2024-03-10T15:01:10",
"cardCount": 3,
"announcements": []
},
{
"id": 142,
"name": "和音屋之心城店",
"updateTime": "2024-03-10T14:04:33",
"cardCount": 3,
"announcements": []
},
{
"id": 4,
"name": "星际传奇合肥蜀山万象城店",
"updateTime": "2024-03-10T16:35:25",
"cardCount": 5,
"announcements": []
},
{
"id": 7,
"name": "星世纪合肥唯品会店",
"updateTime": "2024-03-10T15:08:54",
"cardCount": 5,
"announcements": []
},
{
"id": 2,
"name": "super101合肥店",
"updateTime": "2024-03-10T14:25:24",
"cardCount": 5,
"announcements": []
},
{
"id": 6,
"name": "大玩家合肥包河万达店",
"updateTime": "2024-03-10T14:02:30",
"cardCount": 5,
"announcements": []
},
{
"id": 153,
"name": "卡迪龙合肥包河漫乐城店",
"updateTime": "2024-03-10T15:47:08",
"cardCount": 6,
"announcements": []
},
{
"id": 197,
"name": "润宝梦想潮玩合肥包河大融城店",
"updateTime": "2024-03-10T10:35:45",
"cardCount": 6,
"announcements": []
},
{
"id": 199,
"name": "电玩猩合肥百盛店",
"updateTime": "2024-03-10T15:24:50",
"cardCount": 7,
"announcements": []
},
{
"id": 3,
"name": "天空之城合肥蜀山之心店",
"updateTime": "2024-03-10T16:20:27",
"cardCount": 8,
"announcements": []
},
{
"id": 193,
"name": "贝乐迪合肥港澳广场店",
"updateTime": "2024-03-10T15:38:49",
"cardCount": 8,
"announcements": []
},
{
"id": 120,
"name": "城市星空合肥包河店",
"updateTime": "2024-03-10T14:26:09",
"cardCount": 8,
"announcements": []
},
{
"id": 1,
"name": "风云再起淮河路店",
"updateTime": "2024-03-10T16:01:05",
"cardCount": 11,
"announcements": []
}
],
"nonUpdatedPlacesWithAnnouncements": [
{
"id": 11,
"name": "星际传奇合肥高新店",
"updateTime": "2024-03-10T04:00:00",
"cardCount": 0,
"announcements": [
{
"id": 27
}
]
}
]
}
{
"updatedPlaces": [
{
"id": 343,
"name": "super101天界区域店",
"updateTime": "2026-03-29T16:46:11",
"cardCount": 1,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 5,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 1
}
]
},
{
"id": 344,
"name": "风云再起天界区域店",
"updateTime": "2026-03-29T16:46:06",
"cardCount": 2,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 1,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 2
}
]
},
{
"id": 345,
"name": "风云再起天界区域店2",
"updateTime": "2026-03-29T16:46:08",
"cardCount": 4,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 6,
"game": {
"id": 1,
"name": "舞萌",
"order": 0
},
"cardCount": 4
}
]
}
],
"nonUpdatedPlacesWithAnnouncements": []
}
200 OK: GET: /city/天界区域/card?gameName=chu
{
"updatedPlaces": [
{
"id": 345,
"name": "风云再起天界区域店2",
"updateTime": "2026-03-29T16:46:08",
"cardCount": 1,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 4,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 1
}
]
},
{
"id": 344,
"name": "风云再起天界区域店",
"updateTime": "2026-03-29T16:46:06",
"cardCount": 4,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 3,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 4
}
]
},
{
"id": 343,
"name": "super101天界区域店",
"updateTime": "2026-03-29T16:46:11",
"cardCount": 6,
"isUpdated": true,
"announcements": [],
"placeGames": [
{
"id": 2,
"game": {
"id": 2,
"name": "中二节奏",
"order": 1
},
"cardCount": 6
}
]
}
],
"nonUpdatedPlacesWithAnnouncements": []
}