获取顶部公告

所需 OAuth scope：announcement:read

获取显示位置为 top 的公告。

鉴权：OAuth2 Access Token，Authorization: Bearer {{oauthAccessToken}}

OAuth2：支持 OAuth2 Access Token，需要 scope announcement:read

错误响应：

code	msg
401	authorization header is missing
401	authorization header format must be Bearer {token}
401	invalid token
401	access token expired
401	token has been revoked
503	token validation temporarily unavailable
403	OAuth2权限不足，需要以下权限之一: announcement:read
500	获取公告失败

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "code": 200,
  "msg": "获取成功",
  "data": {
    "items": [
      {
        "id": 1,
        "title": "节点维护通知",
        "content": "今晚 23:00 - 24:00 部分节点维护。",
        "level": "warning",
        "display_type": "top",
        "need_modal": true,
        "action_label": "查看详情",
        "action_url": "https://example.com/notice/1",
        "created_at": "2026-09-28T12:00:00+08:00",
        "updated_at": "2026-09-28T12:00:00+08:00"
      }
    ]
  }
}

🟠401错误 401

🟠403错误 403

🔴500错误 500

🔴503错误 503

请求参数

请求示例代码

返回响应