API de Traducciones Unificado para Frontend y Móvil

API de Traducciones Unificado & para Móvil

La plataforma expone un contrato de traducción compartido que funciona tanto para páginas de Inertia como para aplicaciones móviles.

Endpoint

• GET /api/translations para clientes web/móvil
• GET /locale/translations para flujos web autenticados

Parámetros de Consulta

• locale: locale principal (ejemplo: en)
• locales: locales separados por comas para cargas de múltiples locales (ejemplo: en,bn,ar)
• namespaces: espacios de nombres separados por comas (ejemplo: platformkit,accounting)
• module o modules: inferir espacios de nombres por nombre(s) de módulo
• path o page: inferir espacios de nombres por ruta de página (ejemplo: admin/system/accounting/reports)

Forma de Respuesta

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

Cómo lo Usa Inertia

Las páginas de Inertia reciben metadatos de traducción (locale + espacios de nombres) y cargan de manera diferida las traducciones reales desde /api/translations. Las respuestas se almacenan en caché en el almacenamiento de sesión para reducir solicitudes repetidas.

Cómo lo Usa Móvil

Las aplicaciones móviles pueden solicitar todos los espacios de nombres y locales requeridos en una sola solicitud, luego almacenar en caché translations_by_locale localmente para uso offline y renderizado rápido de pantallas.

Mejores Prácticas

• Siempre solicita solo los espacios de nombres requeridos por pantalla/módulo.
• Usa locales al precargar paquetes de idioma en el tiempo de inicio de la aplicación.
• El retroceso a en es automático cuando un archivo de locale no existe.