HTTP API

不支持 MCP 的客户端可以直接使用稳定的 HTTP API。

鉴权

HTTP API 使用 Authorization: Bearer <API_KEY>。不要把密钥写入查询参数。

响应格式

业务接口使用统一响应信封：

{
  "ok": true,
  "data": {},
  "error": null
}

请求规则

客户端可以发送 X-Client-Source 和 X-Request-ID。创建类请求应按接口契约使用 Idempotency-Key，避免网络重试产生重复数据。

完整契约

端点、字段和错误码请以HTTP API 契约 ↗为准。