公告
大约 2 分钟
根 URL：
/place/{cityName}/{placeName}/announcement
POST 为指定机厅新增公告
为指定机厅新增公告
子 URI：
为指定机厅新增一个公告。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Body | uploaderId | Long | 是 | 发布者 QQ 号 |
| Body | uploaderGroupId | Long | 是 | 发布者 QQ 群号 |
| Body | content | String | 是 | 公告内容 |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| id | Long | 公告 ID |
| uploaderId | Long | 发布者 QQ 号 |
| uploaderGroupId | Long | 发布者 QQ 群号 |
| content | String | 公告内容 |
| createTime | Datetime | 公告发布时间 |
| expireTime | Datetime | 公告过期时间 |
| place | Object | 地点信息 |
| > id | Integer | 地点 ID |
| > name | String | 地点全称 |
Examples
200 OK: POST: /place/安徽省合肥市/泛时空/announcement
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2024-01-16T15:00:26.420054",
"expireTime": "2024-01-23T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
PUT 为指定机厅的指定公告续期一周
为指定机厅的指定公告续期一周
子 URI：
/{announcementId}/renewal
为指定机厅的指定公告续期一周。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Path | announcementId | Long | 是 | 公告 ID |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| id | Long | 公告 ID |
| uploaderId | Long | 发布者 QQ 号 |
| uploaderGroupId | Long | 发布者 QQ 群号 |
| content | String | 公告内容 |
| createTime | Datetime | 公告发布时间 |
| expireTime | Datetime | 公告过期时间 |
| place | Object | 地点信息 |
| > id | Integer | 地点 ID |
| > name | String | 地点全称 |
Examples
200 OK: POST: /place/安徽省合肥市/泛时空/announcement/114514/renewal
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2024-01-16T15:00:26.420054",
"expireTime": "2024-01-30T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
DELETE 删除指定机厅的指定公告
删除指定机厅的指定公告
子 URI：
/{announcementId}
删除指定机厅的指定公告。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Path | announcementId | Long | 是 | 公告 ID |
Responses
| 字段名 | 数据类型 | 说明 |
|---|---|---|
| id | Long | 公告 ID |
| uploaderId | Long | 发布者 QQ 号 |
| uploaderGroupId | Long | 发布者 QQ 群号 |
| content | String | 公告内容 |
| createTime | Datetime | 公告发布时间 |
| expireTime | Datetime | 公告过期时间 |
| place | Object | 地点信息 |
| > id | Integer | 地点 ID |
| > name | String | 地点全称 |
Examples
200 OK: DELETE: /place/安徽省合肥市/泛时空/announcement/114514
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2024-01-16T15:00:26.420054",
"expireTime": "2024-01-30T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}