智能翻译助手 · 技术文档

应用默认监听 8090 端口（server.port），接口前缀统一为 /api/：

# 本地开发
http://localhost:8090/api/...

# 页面（Thymeleaf 服务端渲染）
http://localhost:8090/translate  /document  /chat  /membership ...

除 SSE 流式响应、文件二进制流、支付回调（纯文本）外，所有 /api/** 响应由 ApiResponseAdvice 统一包装为以下结构：

{
  "success": true,          // 业务是否成功
  "message": "操作成功",     // 人类可读的提示信息
  "data": { ... },           // 业务数据（各接口定义见对应章节）
  "error": null              // 失败时的错误码，成功时为 null
}

客户端取业务数据一律读取 data 字段；判断成败以 success 为准。

# 方式一：请求头携带 JWT（推荐）
Authorization: Bearer {token}

# 方式二：Cookie（浏览器端登录后自动携带）
Cookie: auth_token={token}

登录、注册、发送验证码、支付回调等白名单接口无需认证，完整白名单见「02 认证与鉴权」。

所有分页接口的 page 参数从 0 开始（0 = 第一页）， 服务端内部转换为 MyBatis-Plus 的 1 起始页码，响应中的 page 仍按 0 起始返回。

{
  "data": [ ... ],           // 当前页记录列表
  "page": 0,                 // 当前页码（0 起始，回显请求值）
  "size": 20,                // 每页条数
  "totalPages": 12,          // 总页数
  "totalElements": 231       // 总记录数
}

• 文本翻译：按字符数计费，点数 = max(1, ceil(字符数 / 1000))（每 1000 字符 1 点，不足 1000 按 1 点）。
• 文档翻译：按页计费，1 点 / 页，翻译开始前一次性预扣。
• 扣减顺序：点数余额优先扣减，不足部分由会员月度额度补足；余额与额度均不足时返回 HTTP 402。
• 缓存命中：相同翻译请求命中缓存时直接返回，不扣点。
• Mock 引擎：未配置引擎时路由到 Mock 演示引擎，结果返回后自动退回点数，便于联调测试。