مُحَوِّل OpenAPI من v2 إلى v3

مُحَوِّل OpenAPI من v2 إلى v3

الصق مُحدد Swagger 2.0 واحصل على نسخة صالحة من OpenAPI 3.0.3 بصيغة JSON أو YAML. يُطبّق المُحول القواعد الرسمية للتحويل الهيكلي — يُنقل definitions تحت components/schemas، يُقلل host, basePathو، و schemes داخل servers، يُقسّم consumes و produces إلى مُدخلات لكل عملية content ، ويُعيد تشكيل معلمات النموذج وتعريفات الأمان — بحيث يعمل مُحددك مع أدوات OpenAPI الحديثة.

كيفية استخدام

1. الصق مُحددك من Swagger 2.0 في مربع الإدخال. تُقبل الصيغة JSON وYAML؛ يتم اكتشاف الصيغة تلقائيًا.
2. اختر صيغة المخرج: احتفظ بالصيغة المدخلة، أو قسّم إلى JSON أو YAML.
3. أترك إضافة حقول مطلوبة مفقودة إلى تعبئة الحقول المطلوبة في v3 مثل info.title, info.version، ووصف الاستجابات المفقودة عندما يُستبعدها المصدر v2.
4. اقرأ ملخص التحويل والتحذيرات المُعرضة أعلاه، ثم نسخ أو تحميل المُحدد الناتج من OpenAPI 3.0.3.

خصائص

• مُدخلات JSON وYAML، مُخرجات JSON أو YAML — اختر الصيغة التي تفضلها، أو اجعلها مطابقة للإدخال.
• التحويل الهيكلي — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses يُرفع تحت components، وكل $ref مُشير يُعاد صياغته ليتوافق.
• الخدمات من host، basePath، schemes — تُدمج إلى المصفوفة v3، مع تفضيل HTTPS عند وجود أكثر من نمط. servers التفاوض على المحتوى
• يُحول إلى مُدخلات لكل عملية — consumes و produces مُدخلات requestBody.content و responses[*].content مُدخلات
• معلمات الطلب والنموذج — in: body تُصبح حقول v3 requestBodyو، و in: formData الحقول المُجمعة إلى multipart/form-data أو application/x-www-form-urlencoded مخطط طلب.
• تحسين تدفق الأمان — القيم OAuth2 flow تُعاد تعيينها على المُخطط v3 flows النظامimplicit, password, clientCredentials, authorizationCode).
• وضع التصحيح — عند التفعيل، يملأ الحقول المفقودة بحيث يمر المخرج بفحص v3 بدلًا من فشله بسبب عيوب طفيفة في المصدر.
• ملخص التحويل والتحذيرات — عدد المسارات، المخططات، ونماذج الأمان المُحول، بالإضافة إلى التحذيرات حول أي شيء لا يمكن تعيينه بشكل مباشر.
• يُشغل بالكامل في المتصفح الخاص بك — لا يغادر مُحددك الصفحة.