创建版块公告

POST

/moderator/categories/announcement

版主为自己管理的版块创建公告

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "category_id": 1,
    "content": "版块公告内容",
    "is_pinned": true,
    "title": "版块公告标题"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/moderator/categories/announcement' \
--header 'Authorization: {{Authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "category_id": 1,
    "content": "版块公告内容",
    "is_pinned": true,
    "title": "版块公告标题"
}'

返回响应

🟢200成功

application/json

创建成功

Body

示例

{
    "code": 20000,
    "data": {
        "category_id": 1,
        "content": "版块公告内容",
        "created_at": "2024-01-01T00:00:00Z",
        "id": 1,
        "is_pinned": true,
        "title": "版块公告标题",
        "updated_at": "2024-01-01T00:00:00Z",
        "username": "moderator"
    },
    "msg": null
}

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

修改于 2025-11-27 08:47:01

编辑版块

获取版块公告列表