واجهة موحدة للترجمة على الويب والمحمول

واجهة موحدة & واجهة برمجة التطبيقات لترجمات المحمول

تقدم المنصة عقد ترجمة مشترك يعمل لكل من صفحات Inertia وتطبيقات المحمول.

نقطة النهاية

• GET /api/translations لعملاء الويب/المحمول
• GET /locale/translations لتدفقات الويب المعتمدة

معلمات الاستعلام

• locale: اللغة الأساسية (مثال: en)
• locales: لغات مفصولة بفواصل لحمولات متعددة اللغات (مثال: en,bn,ar)
• namespaces: مساحات أسماء مفصولة بفواصل (مثال: platformkit,accounting)
• module أو modules: استنتاج مساحات الأسماء من اسم(module) أو الأسماء
• 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 تلقائية عندما لا يوجد ملف لغة.