Place

ArgonarioD大约 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": [
          "大玩家莆田城厢万达店",
          "大玩家莆田秀屿万达店",
          "蓝鲸乐园莆田仙游店"
        ]
      }
    ]
  }
}

Place

# getPlaceByName

# Parameters

# Responses

# Examples

# 200 OK: GET: /place/安徽省合肥市/风云

# updatePlaceByName

# Parameters

# Responses

# Examples

# 200 OK: PUT: /place/安徽省合肥市/风云

# setPlaceByName

# Parameters

# Responses

# Examples

# 200 OK: PUT: /place/安徽省合肥市/风云

# getCityPlacesAscList

# Parameters

# Responses

# Examples

# 200 OK: GET: /place/list/安徽省合肥市

# getSupportedPlaceNames

# Parameters

# Responses

# Examples

# 200 OK: GET: /place/supported

getPlaceByName

Parameters

Responses

Examples

200 OK: `GET: /place/安徽省合肥市/风云`

updatePlaceByName

Parameters

Responses

Examples

200 OK: `PUT: /place/安徽省合肥市/风云`

setPlaceByName

Parameters

Responses

Examples

200 OK: `PUT: /place/安徽省合肥市/风云`

getCityPlacesAscList

Parameters

Responses

Examples

200 OK: `GET: /place/list/安徽省合肥市`

getSupportedPlaceNames

Parameters

Responses

Examples

200 OK: `GET: /place/supported`