公告
大约 4 分钟
根 URL：
/place/{cityName}/{placeName}/announcement
POST为指定机厅新增公告
POST为指定机厅新增公告
为指定机厅新增公告
子 URI：
/v2
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Body | content | String | 是 | 公告内容 |
| Body | operator | Object | 是 | 操作者信息 |
| Body | > operatorId | Long | 是 | 操作者 ID |
| Body | > operatorGroupId | 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/v2
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2026-03-28T15:00:26",
"expireTime": "2026-04-04T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
PUT操作公告（续期或删除）
PUT操作公告（续期或删除）
操作公告（续期或删除）
子 URI：
/v2/{announcementId}
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Path | announcementId | Long | 是 | 公告 ID |
| Body | operateType | String | 是 | 操作类型，"RENEWAL"（为该公告续期一周）或"DELETE"（删除该公告） |
| Body | operator | Object | 是 | 操作者信息 |
| Body | > operatorId | Long | 是 | 操作者 ID |
| Body | > operatorGroupId | Long | 是 | 操作者群 ID |
Responses
响应结构与新增公告一致。
Examples
200 OK: PUT: /place/安徽省合肥市/泛时空/announcement/v2/114514
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2026-03-28T15:00:26",
"expireTime": "2026-04-11T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
POST为指定机厅新增公告（旧版）
过时于3.3.0，请使用为指定机厅新增公告接口。
POST为指定机厅新增公告（旧版）
过时于3.3.0，请使用为指定机厅新增公告接口。
为指定机厅新增公告（旧版）
子 URI：
为指定机厅新增一个公告。
该接口预计于 2026 年 7 月 15 日下线。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Body | uploaderId | Long | 是 | 发布者 QQ 号 |
| Body | uploaderGroupId | Long | 是 | 发布者 QQ 群号 |
| Body | content | String | 是 | 公告内容 |
Responses
响应结构与新版一致。
Examples
200 OK: POST: /place/安徽省合肥市/泛时空/announcement
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2026-03-28T15:00:26",
"expireTime": "2026-04-04T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
PUT为指定机厅的指定公告续期一周（旧版）
过时于3.3.0，请使用操作公告（续期或删除）接口。
PUT为指定机厅的指定公告续期一周（旧版）
过时于3.3.0，请使用操作公告（续期或删除）接口。
为指定机厅的指定公告续期一周（旧版）
子 URI：
/{announcementId}/renewal
为指定机厅的指定公告续期一周。
该接口预计于 2026 年 7 月 15 日下线。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Path | announcementId | Long | 是 | 公告 ID |
Responses
响应结构与新增公告一致。
Examples
200 OK: PUT: /place/安徽省合肥市/泛时空/announcement/114514/renewal
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2026-03-28T15:00:26",
"expireTime": "2026-04-11T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}
DELETE删除指定机厅的指定公告（旧版）
过时于3.3.0，请使用操作公告（续期或删除）接口。
DELETE删除指定机厅的指定公告（旧版）
过时于3.3.0，请使用操作公告（续期或删除）接口。
删除指定机厅的指定公告（旧版）
子 URI：
/{announcementId}
删除指定机厅的指定公告。
该接口预计于 2026 年 7 月 15 日下线。
Parameters
| 参数类型 | 字段名 | 数据类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| Path | cityName | String | 是 | 准确省市全称 |
| Path | placeName | String | 是 | 模糊地点名/别名 |
| Path | announcementId | Long | 是 | 公告 ID |
Responses
响应结构与新增公告一致。
Examples
200 OK: DELETE: /place/安徽省合肥市/泛时空/announcement/114514
{
"id": 114514,
"uploaderId": 12345678,
"uploaderGroupId": 87654321,
"content": "1p坏了，只能单刷",
"createTime": "2026-03-28T15:00:26",
"expireTime": "2026-04-11T04:00:00",
"place": {
"id": 114,
"name": "泛时空合肥庐阳店"
}
}