城市

ArgonarioD大约 4 分钟

根 URL：/city

GET 查询所有支持城市列表

查询所有支持城市列表

子 URI：

获取本服务所有支持的城市的列表。

Parameters

Responses

本接口的响应本身是一个 JSON 列表。

字段名	数据类型	说明
> id	Long	城市 ID
> name	String	城市名

Examples

200 OK: `GET: /city`

[
  {
    "id": 20,
    "name": "上海市"
  },
  {
    "id": 1,
    "name": "安徽省合肥市"
  },
  {
    "id": 2,
    "name": "安徽省宣城市"
  },
  {
    "id": 3,
    "name": "安徽省芜湖市"
  },
  {
    "id": 31,
    "name": "安徽省蒙城县"
  },
  {
    "id": 4,
    "name": "安徽省阜阳市"
  },
  {
    "id": 26,
    "name": "山东省临沂市"
  },
  {
    "id": 19,
    "name": "河北省秦皇岛市"
  },
  {
    "id": 21,
    "name": "甘肃省兰州市"
  },
  {
    "id": 27,
    "name": "福建省莆田市"
  },
  {
    "id": 33,
    "name": "江苏省南京市"
  },
  {
    "id": 34,
    "name": "安徽省淮北市"
  },
  {
    "id": 35,
    "name": "四川省广安市"
  },
  {
    "id": 36,
    "name": "安徽省蚌埠市"
  },
  {
    "id": 37,
    "name": "安徽省巢湖市"
  }
]

GET查询指定城市的卡数更新情况

查询指定城市的卡数更新情况

子 URI：/{cityName}/card

查询指定城市的所有已更新地点的卡数和公告数，以及所有未更新卡数但存在公告的地点，并按卡数的正序、更新时间的倒序返回。

Parameters

参数类型	字段名	数据类型	是否必须	说明
Path	cityName	String	是	准确省市全称

Responses

本接口的响应会受到 Gzip 压缩。

字段名	数据类型	说明
updatedPlaces	Array	已更新地点
> id	Integer	地点 ID
> name	String	地点全称
> updateTime	Datetime	更新时间
> cardCount	Integer	当前排卡数
> announcements	Array	公告
>> id	Long	公告 ID
nonUpdatedPlacesWithAnnouncements	Array	未更新但存在公告的地点
> id	Integer	地点 ID
> name	String	地点全称
> updateTime	Datetime	更新时间
> cardCount	Integer	当前排卡数
> announcements	Array	公告
>> id	Long	公告 ID

Examples

200 OK: `GET: /city/安徽省合肥市/card`

{
    "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
                }
            ]
        }
    ]
}

GET查询指定城市的所有已更新地点（机厅）

过时于3.2.0，请使用查询指定城市的卡数更新情况接口。

查询指定城市的所有已更新地点（机厅）

子 URI：/{cityName}/updated

查询指定城市的所有已更新地点的卡数和公告数，并按卡数的正序、更新时间的倒序返回。

Parameters

参数类型	字段名	数据类型	是否必须	说明
Path	cityName	String	是	准确省市全称

Responses

本接口的响应本身是一个 JSON 列表。

本接口的响应会受到 Gzip 压缩。

字段名	数据类型	说明
> id	Integer	地点 ID
> name	String	地点全称
> updateTime	Datetime	更新时间
> cardCount	Integer	当前排卡数
> announcements	Array	公告
>> id	Long	公告 ID

Examples

200 OK: `GET: /city/安徽省合肥市/updated`

[
  {
    "id": 144,
    "name": "星世纪湖滨融创茂店",
    "updateTime": "2024-01-20T17:50:43",
    "cardCount": 0,
    "announcements": []
  },
  {
    "id": 6,
    "name": "大玩家合肥包河万达店",
    "updateTime": "2024-01-20T17:52:42.165127",
    "cardCount": 1,
    "announcements": []
  },
  {
    "id": 10,
    "name": "真快活合肥银泰城店",
    "updateTime": "2024-01-20T10:40:08.376874",
    "cardCount": 1,
    "announcements": []
  },
  {
    "id": 7,
    "name": "星世纪合肥唯品会店",
    "updateTime": "2024-01-20T13:14:53",
    "cardCount": 2,
    "announcements": []
  },
  {
    "id": 193,
    "name": "贝乐迪合肥港澳广场店",
    "updateTime": "2024-01-20T17:53:28.816965",
    "cardCount": 4,
    "announcements": []
  },
  {
    "id": 12,
    "name": "星际传奇合肥庐阳万科店",
    "updateTime": "2024-01-20T17:27:32",
    "cardCount": 4,
    "announcements": []
  },
  {
    "id": 114,
    "name": "泛时空合肥庐阳店",
    "updateTime": "2024-01-20T16:12:04.181265",
    "cardCount": 4,
    "announcements": [
      {
        "id": 20
      }
    ]
  },
  {
    "id": 153,
    "name": "卡迪龙合肥包河漫乐城店",
    "updateTime": "2024-01-20T17:56:45.450639",
    "cardCount": 5,
    "announcements": []
  },
  {
    "id": 11,
    "name": "星际传奇合肥高新店",
    "updateTime": "2024-01-20T17:29:07",
    "cardCount": 6,
    "announcements": [
      {
        "id": 21
      }
    ]
  },
  {
    "id": 3,
    "name": "天空之城合肥蜀山之心店",
    "updateTime": "2024-01-20T17:25:49.208917",
    "cardCount": 10,
    "announcements": []
  }
]

城市

# 查询所有支持城市列表

# Parameters

# Responses

# Examples

# 200 OK: GET: /city

# 查询指定城市的卡数更新情况

# Parameters

# Responses

# Examples

# 200 OK: GET: /city/安徽省合肥市/card

# 查询指定城市的所有已更新地点（机厅）

# Parameters

# Responses

# Examples

# 200 OK: GET: /city/安徽省合肥市/updated

查询所有支持城市列表

Parameters

Responses

Examples

200 OK: `GET: /city`

查询指定城市的卡数更新情况

Parameters

Responses

Examples

200 OK: `GET: /city/安徽省合肥市/card`

查询指定城市的所有已更新地点（机厅）

Parameters

Responses

Examples

200 OK: `GET: /city/安徽省合肥市/updated`