GET公开接口

获取公开公告列表

获取可展示给终端用户的公告列表。

URL

/api/v1/public/{projectKey}/announcements

鉴权方式

无需鉴权

请求参数

Path 参数

名称类型必填说明
projectKeystring项目标识

Query 参数

名称类型必填说明
limitnumber分页大小
offsetnumber分页偏移

该接口无需请求体。

响应示例

200 响应

{
  "total": 2,
  "data": [
    {
      "id": "ann-001",
      "title": "服务升级",
      "content": "本周六进行系统维护",
      "is_pinned": true,
      "published_at": 1760000000
    }
  ]
}
GET

Try It Out

请求 URL 预览

/api/v1/public/{projectKey}/announcements