الانتقال إلى المحتوى الرئيسي
هذه الصفحة هي المرجع الحي لرموز اللغات التي تقبلها واجهة Didit API. تُشير إليها مواصفات OpenAPI لكل من حقل language على مستوى الجلسة وحقل contact_details.email_lang في إنشاء جلسة.

أين تُطبَّق هذه الرموز

تُقبل المجموعة نفسها من الرموز في كل موضع يمكن فيه ضبط اللغة: إذا كانت لغة متصفح المستخدم مدعومة، تكتشفها واجهة التحقق تلقائياً، وإلا فإنها تعود إلى الإنجليزية (en). وإذا لم تُمرِّر email_lang، تعود رسائل البريد الإلكتروني إلى en. جميع القيم حساسة لحالة الأحرف، لذا استخدم الرموز الدقيقة من الجدول أدناه.

جميع اللغات المدعومة

تعكس المجموعة أدناه مفاتيح EMAIL_TRANSLATIONS في الخدمة. فواجهة التحقق وطبقة توطين البريد الإلكتروني تقرآن من القاموس نفسه، لذلك يعمل أي رمز في هذا الجدول مع language وemail_lang معاً. تُعرض ثلاث لغات من اليمين إلى اليسار في واجهة التحقق والرسائل الإلكترونية: العربية (ar) والعبرية (he) والفارسية (fa).
المدققان اللذان يقبلان هذه الرموز هما BaseSessionSerializer.validate_language وContactDetailsSerializer.validate_email_lang. يعيد كلاهما استجابة بحالة 400 مع الرسالة "Invalid language. Supported languages are: ..." (أو "Invalid email language...") لأي قيمة خارج الجدول أعلاه.

اختيار لغة للجلسة

تكتشف واجهة التحقق تلقائياً لغة متصفح المستخدم. عندما تكون لغة المتصفح واحدة من الرموز أعلاه، تُقدَّم الواجهة والرسائل الإلكترونية بتلك اللغة. وإلا تعود الواجهة إلى الإنجليزية. يمكنك أيضاً تحديد اللغة صراحةً عند إنشاء جلسة:
إذا ضبطت language وحده، فستبقى رسائل البريد الإلكتروني بالإنجليزية ما لم تُمرِّر email_lang أيضاً. وبالعكس، لا يغيّر ضبط email_lang لغة واجهة التحقق داخل المتصفح، فالحقلان مستقلان أحدهما عن الآخر.

المتغيرات الإقليمية

ثلاثة رموز هي متغيرات إقليمية يُستحسن اختيارها عندما تعرف جمهورك:
  • pt-BR: البرتغالية البرازيلية (استخدمها بدلاً من pt العام للمستخدمين في البرازيل).
  • zh-CN: الصينية المبسطة (البر الرئيسي للصين وسنغافورة).
  • zh-TW: الصينية التقليدية (تايوان وهونغ كونغ وماكاو).
الرمزان العامان pt وzh مقبولان أيضاً، والمتغير الذي تختاره يؤثر في المفردات والأحرف فقط، ولا يغيّر منطق التحقق نفسه.

طلب لغة جديدة

إذا احتجت إلى لغة غير مدرجة أعلاه، فتواصل مع فريق الدعم لدينا. يمكننا عادةً إضافة لغة جديدة إلى EMAIL_TRANSLATIONS وواجهة التحقق خلال 24 ساعة من طلبك. وبعد الإضافة، تُحدَّث هذه الصفحة ويُقبل الرمز الجديد فوراً في الواجهة البرمجية. تواصل معنا عبر hello@didit.me أو من خلال قناة الدعم المعتادة لطلب دعم لغة إضافية.

المراجع ذات الصلة

API إنشاء الجلسة

حيث يُمرَّر الحقلان language وemail_lang عند بدء عملية التحقق.

تحديث حالة الجلسة

يحدد email_language للبريد الإلكتروني الخاص بإشعار تغيير الحالة.

webhook

استقبل نتائج التحقق، إذ تتضمن payload اللغة المختارة في language.

نماذج البيانات

المخطط المعتمد للجلسات وبيانات الاتصال وحالاتها.
آخر تعديل في ٧ نوفمبر ٢٠٢٦