错误码与附录

{
  "success": true,          // 业务是否成功，客户端首先判断此字段
  "message": "操作成功",      // 人读提示信息
  "data": { ... },          // 业务数据（各章节详述），可为 null
  "error": null              // 成功时为 null；失败时为错误码字符串或错误明细对象
}

HTTP/1.1 402 Payment Required
{
  "success": false,
  "message": "点数不足，无法完成当前操作",
  "data": "点数余额与会员配额不足，无法完成本次翻译",   // data 承载具体原因
  "error": "INSUFFICIENT_POINTS"                        // error 承载机器可读错误码
}

{
  "data": [ ... ],          // 当前页数据数组
  "page": 0,                // 页码，0 起始
  "size": 10,               // 每页条数
  "totalPages": 3,          // 总页数
  "totalElements": 25        // 总条数
}

⚠️ 例外：/api/moments/list 的 data 是自定义 {total, page, size, items} 结构（见 10.4）， 对话历史等个别接口分页字段命名以各章描述为准。

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{ "code": 401, "message": "Missing token" }        // 未携带 Token
{ "code": 401, "message": "Token expired" }         // Token 已过期
{ "code": 401, "message": "Session expired" }       // 会话失效
{ "code": 401, "message": "Invalid token" }         // Token 非法

客户端解析错误响应时务必同时兼容两种结构：拦截器 401 用 code/message， 业务错误用 success/message/error。判断依据可用 HTTP 状态码先行分流。

/api/auth/**                        // 注册、登录、Token 签发
/api/payment/**                     // 支付发起、确认、回调（第 09 章）
/api/membership/order               // 创建订单（第 09 章）
/api/membership/order/**            // 订单查询
/api/translation/platform-stats     // 平台公开统计
/static/**  /css/**  /js/**  /images/**  /webjars/**
/favicon.ico  /error

async function apiFetch(url, options = {}) {
  const resp = await fetch(url, {
    ...options,
    headers: { 'Authorization': `Bearer ${token}`, ...options.headers }
  });

  // 拦截器 401：原生 JSON {code, message}，需要重新登录
  if (resp.status === 401) { redirectToLogin(); return; }

  // SSE / 文件流等非 JSON 响应直接透传
  const ct = resp.headers.get('content-type') || '';
  if (!ct.includes('application/json')) return resp;

  const body = await resp.json();
  if (!body.success) {
    // body.error 为错误码，body.message 人读提示，body.data 常为具体原因
    throw new ApiError(body.error, body.message, body.data, resp.status);
  }
  return body.data;
}

当前版本固定开放这两个引擎；传其他值或留空时由服务端按默认策略选择。 引擎不可用时自动降级为 Mock 占位结果并退还扣点（见 8.1）。

zh（中文）    en（英语）      ja（日语）    ko（韩语）    fr（法语）
de（德语）    es（西班牙语）  ru（俄语）    ar（阿拉伯语） pt（葡萄牙语）

所有语言相关字段（源 / 目标语言、术语语言对、用户默认语言配置）均使用上述小写代码； 源语言传 auto 时自动检测（检测语言不入库、不回写请求参数）。