返回结构与错误

Axiora 的接口不是“裸数组”式返回，而是围绕 data、meta、links 组织统一 envelope。写客户端时，应先按 envelope 解析，再处理内部字段。

统一响应 envelope

单对象响应通常包含：

• data：真正的业务对象
• links：当前资源或相关链接

集合接口模式

集合响应在 data 之外，通常还会多出：

• meta：分页和结果规模信息
• links：翻页或自引用信息

错误响应

OpenAPI 里统一定义了未授权、未找到和参数错误等常见失败返回。客户端至少要做好这几类失败的分支处理。

const response = await fetch(url, options);

if (!response.ok) {
const payload = await response.json();
throw new Error(payload.error?.message ?? "Unknown API error");
}

const payload = await response.json();