Provider Announcement API

供中转站向禾维 AI 发布公开公告的 OpenAPI 3.1 参考。

方法

GET

推荐接口

/api/provider/announcements

Schema Version

1.0

可选 HMAC 鉴权

使用 HMAC-SHA256 对当前 Unix 秒时间戳签名，允许的服务器时间偏差为 60 秒。

X-Hvoy-Ts: 1747886400
X-Hvoy-Sign: 88ce4832...e6becbc

响应要求

必须在 10 秒内返回精确 HTTP 200、UTF-8 application/json、Cache-Control: no-store，且未压缩正文不超过 512 KiB。

response

字段	类型	规则	说明
schema_version	string	必需	协议版本，v1 固定为 1.0。
success	boolean	必需	成功快照固定为 true。
message	string	可选	可选补充信息，成功时建议为空字符串。
data	object	必需	当前公告的完整快照。

data

字段	类型	规则	说明
notice	string	必需	站点总公告；没有时返回空字符串。内部换行和连续空行保留。
announcements	array	必需	当前公告列表；没有时返回空数组，最多 500 条。

data.announcements[]

字段	类型	规则	说明
id	string	必需	稳定且永不复用的公告 ID，匹配 [A-Za-z0-9._:-]{1,160}。
title	string	可选	可选纯文本标题，最多 120 个 Unicode code point。
content	string	必需	必需纯文本正文，最多 900 个 Unicode code point；内部换行保留。
publishDate	string	可选	可选带时区发布时间，使用规范限定的 ISO 8601 格式。
type	string	可选	可选类型；标准值为 general、maintenance、incident、pricing、promotion，未知非空值会规范化为 general。

成功示例

{
  "schema_version": "1.0",
  "success": true,
  "message": "",
  "data": {
    "notice": "服务运行正常，最新维护和故障信息请查看公告列表。",
    "announcements": [
      {
        "id": "announcement-20260804-001",
        "title": "Claude 官渠恢复通知",
        "content": "Claude 官渠已经恢复，相关模型现已正常使用。",
        "publishDate": "2026-08-04T09:30:00Z",
        "type": "incident"
      },
      {
        "id": "announcement-20260801-001",
        "title": "系统维护通知",
        "content": "系统将进行例行维护，维护期间部分请求可能出现短暂延迟。",
        "publishDate": "2026-08-01T02:00:00Z",
        "type": "maintenance"
      }
    ]
  }
}