平台通知 - API 文档

接口说明 这是什么

平台通知 用于接收平台（管理员）推送给你的消息：系统公告、余额不足告警、套餐变动等。

有什么用：客户端（如 OpenClaw 等自动化工具）定期轮询本接口，有新消息时提醒用户；消息处理后调用 POST 标记已读。

请求信息

项目	值
请求方法	GET 拉取未读 / POST 标记已读
请求路径	https://103.236.87.35/v1/notifications
请求头	Authorization: Bearer <你的密钥> Content-Type: application/json（POST 时）
是否需要鉴权	必需
是否计费	不计费

① 拉取未读消息 GET /v1/notifications

请求参数

GET 请求，无需请求体参数，只需携带鉴权头。

请求示例

curl https://103.236.87.35/v1/notifications \
  -H "Authorization: Bearer <你的密钥>"

返回示例

{
  "ok": true,
  "messages": [
    {
      "id": 6,
      "content": "您的余额不足，请及时充值",
      "created_at": "2026-09-08 10:00:00"
    }
  ]
}

返回字段说明

字段名	类型	说明
ok	boolean	是否成功
messages[].id	integer	消息 ID，标记已读时使用
messages[].content	string	消息内容
messages[].created_at	string	推送时间

只返回未读消息（read_at IS NULL），按时间升序。

② 标记已读 POST /v1/notifications

请求参数

参数名	类型	必填	默认值	说明
ids	array	否	全部	要标记已读的消息 ID 数组，如 [1, 2]；缺省或空数组 = 全部标记已读

请求示例

curl -X POST https://103.236.87.35/v1/notifications \
  -H "Authorization: Bearer <你的密钥>" \
  -H "Content-Type: application/json" \
  -d '{"ids": [6, 7]}'

返回示例

{"ok": true}

返回字段说明

字段名	类型	说明
ok	boolean	是否成功

其他接口

接口	说明
POST /v1/chat/completions	Chat 对话（流式 SSE）	查看 →
POST /v1/completions	文本补全	查看 →
POST /v1/embeddings	向量嵌入	查看 →
POST /v1/responses	Responses API	查看 →
GET /v1/models	模型列表	查看 →
GET /v1/me	账号余额查询	查看 →
GET/POST /v1/notifications	平台通知	查看 →
GET /v1/_install_check	安装自检	查看 →