اللغات
كل لغة يمكن إرسال رسالة بها. بلا معاملات، وبلا مؤشر، وبلا نطاق.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /languages
كل لغة يمكن إرسال رسالة بها. بلا معاملات، وبلا مؤشر، وبلا نطاق.
سردها
مئتا صف، كاملة، في استجابة واحدة. اجلبها مرة واحدة واحتفظ بها. فالعميل الذي يثبّت القائمة في الكود أو يكشطها من مستند OpenAPI يتقادم يوم يُضاف صف.
curl "$OE/languages" -H "$AUTH"{ "object": "list", "data": [ { "code": "en", "label": "English", "native": "English", "flag": "🇬🇧", "rtl": false }, { "code": "de", "label": "German", "native": "Deutsch", "flag": "🇩🇪", "rtl": false }, { "code": "ar", "label": "Arabic", "native": "العربية", "flag": "🇸🇦", "rtl": true }, { "code": "ja", "label": "Japanese", "native": "日本語", "flag": "🇯🇵", "rtl": false } ]}خلف مفتاح كغيرها ولا تحتاج أي نطاق: فهي لا تسمّي بيانات تخص أحدًا، والنطاق الذي يحرس ثابتًا لا يزيد شاشة الموافقة إلا طولًا.
rtl قيمة منطقية دائمًا هنا. وستة عشر صفًا قيمتها true (العربية والعبرية والفارسية والأردية وغيرها)، والنص المترجَم إلى إحداها يُركَّب من اليمين إلى اليسار.
اللغة
الاستجابة
codestring- رمز BCP-47، وهو الصيغة التي تُخزَّن. و`translate.to` يقبل الصيغتين الأخريين كذلك ويجيب دائمًا بهذه.
labelstring- الاسم الإنجليزي: "Brazilian Portuguese". وهو السطر الثاني الخافت في المنتقي.
nativestring- ما تسمّي به اللغة نفسها: "Português (Brasil)". اعرض هذا أولًا: فهو اللفظ الذي يبحث عنه فعلًا من يبحث عن لغته.
flagstring- نقطتا ترميز من مؤشرات المناطق. وهو عون بصري للمسح إلى جانب الاسم المحلي ولا يكون أبدًا معرّفًا ولا تسمية قائمة بذاتها. فالعلم دولة، والدولة ليست لغة، والإسبانية ليست إسبانيا كما أن الإنجليزية ليست ملكًا لإنجلترا.
rtlboolean- ما إذا كانت اللغة تُكتب من اليمين إلى اليسار. حاضر دائمًا، بينما يحذفه الجدول الأصلي حين يكون false.
الترتيب هو الجواب
تصل الصفوف بترتيب المنتقي ولا ينبغي إعادة ترتيبها افتراضيًا: فاللغات التي يُرجَّح أن يُراسَل بها الناس أولًا، ثم المتغيرات الإقليمية، ثم البقية حسب المنطقة. أما الترتيب الأبجدي حسب الاسم الإنجليزي فيفتح المنتقي على الأبخازية.
ابحث في native وlabel وcode معًا، واعرض القائمة كما تصل إلى أن يكتب أحدهم. وtranslate.to يقبل أيًّا من الثلاثة، ومن ثم فإن منتقيًا يخزّن code ويبحث في الثلاثة لا يمكن أن ينتج قيمة يرفضها الإرسال.