المواصفات المترجمة
المواصفة التي ترفعها هي مستند OpenAPI الأساسي. عروض اللغة هي طبقات لغة: مستندات ترقيع منفصلة تُطبَّق عند قراءة المواصفة، حسب اللغة التي اختارها الزائر في البوابة.
- إن لم توجد طبقة لتلك اللغة، تقدّم البوابة المواصفة الأساسية.
- إن وُجدت طبقة وتعذّر تطبيقها، تقدّم البوابة المواصفة الأساسية وتعرض تحذيرًا حتى تعرف أنك لا ترى العرض المترجم.
- الطبقات ليست نسخة ثانية من المواصفة كاملة. تغيّر فقط الأهداف التي تسمّيها؛ ويبقى الباقي كما رُفع.
يختار المسؤولون اللغات التي تعرضها البوابة في المؤسسات. ينبغي أن تطابق تلك اللغات اللغات التي تنشر لها طبقات — وإلا يمكن للزوار اختيار لغة بلا ترجمة.
هذا ليس نفس overlay المستخدم لنشر مواصفة واجهة إدارة المنصة في موقع التوثيق. هنا تصف الطبقة مواصفة منتجك للغة الزائر.
مواضيع ذات صلة
- عرض واجهة برمجة التطبيقات الخاصة بك — أرفق الطبقات عند النشر
- استهلاك واجهة برمجة تطبيقات — اقرأ المواصفة بلغتك
- المرجع — طبقات اللغة — شكل المستند واللغات وسلوك الواجهة البرمجية
- المرجع — الإعدادات — اللغات التي تعرضها البوابة