统一前端与移动翻译API

统一前端 & 移动翻译API

该平台提供一个共享翻译合同，适用于Inertia页面和移动应用。

端点

• GET /api/translations 适用于网页/移动客户端
• GET /locale/translations 适用于经过身份验证的网页流程

查询参数

• locale：主要语言环境（示例：en）
• locales：用于多语言负载的以逗号分隔的语言环境（示例：en,bn,ar）
• namespaces：以逗号分隔的命名空间（示例：platformkit,accounting）
• module 或 modules：通过模块名称推断命名空间
• path 或 page：通过页面路由推断命名空间（示例：admin/system/accounting/reports）

响应结构

{
  "locale": "en",
  "locales": ["en", "bn"],
  "namespaces": ["platformkit", "accounting"],
  "translations": { ...primary locale payload... },
  "translations_by_locale": {
    "en": { ... },
    "bn": { ... }
  }
}

Inertia如何使用它

Inertia页面接收翻译元数据（语言环境 + 命名空间），并从/api/translations懒加载实际翻译。响应被缓存到会话存储中，以减少重复请求。

移动如何使用它

移动应用可以在一次请求中请求所有所需的命名空间和语言环境，然后在本地缓存translations_by_locale以便离线和快速屏幕渲染。

最佳实践

• 始终仅请求每个屏幕/模块所需的命名空间。
• 在应用启动时预加载语言包时使用locales。
• 当语言环境文件不存在时，自动回退到en。