响应格式

管理 API 的响应统一使用如下包装:

{
  "id": "8f14e45f-ea0f-4b1c-9d3a-2f6c8d1e9a01",
  "code": 0,
  "messages": [],
  "result": {}
}
字段 类型 说明
id string 请求 ID,每次响应唯一(UUID)
code number 错误码,0 表示成功,非 0 见 错误码
messages string[] 人类可读消息,成功时为空数组
result any 业务数据,结构由各接口文档定义;接口文档只描述 result 部分

失败时 HTTP 状态码与错误码联动,对应关系见错误码表。

站点内容接口(目录树、搜索、静态内容、健康检查、ACME 质询)返回原始响应,不使用该包装。