响应格式
管理 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 质询)返回原始响应,不使用该包装。
