عارض مواصفات Swagger و OpenAPI

استعراض واختبار وتوثيق مواصفات واجهات البرمجة بصيغتي OpenAPI و Swagger محلياً.

حول عارض مواصفات Swagger و OpenAPI — الدليل التفصيلي

الفئة: DevOps والمعايير معالجة محلية 100% في المتصفح

يُعد عارض OpenAPI أداة قراءة توثيق تعمل من جانب العميل لفحص عقود واجهات برمجة التطبيقات RESTful. حيث يعرض مواصفات Swagger 2.0 و OpenAPI 3.0 / 3.1 بتنسيقات JSON أو YAML دون الحاجة إلى تثبيت Swagger UI محلياً أو الاعتماد على خدمات سحابية.

يوفر شريط تنقل جانبي منظم ومجمع لكافة نقاط النهاية (Endpoints)، حيث يعرض المسارات وطرق HTTP مثل (GET و POST و PUT و DELETE) ومعلمات الترويسة (Headers) وسلاسل الاستعلام (Query Strings) ونصوص الطلبات المهيكلة ورموز استجابة HTTP ومخططات البيانات (Schemas).

#openapi #swagger #api #docs #rest #yaml #json

الميزات والقدرات الرئيسية

  • يدعم مواصفات Swagger 2.0 و OpenAPI 3.0 / 3.1 بتنسيقات JSON و YAML
  • شريط جانبي تفاعلي يسرد نقاط النهاية المصنفة وطرق HTTP ورموز الحالة
  • حل متعمق لمخططات `$ref` يعرض نماذج البيانات المتداخلة وقيود الخصائص
  • تحليل محلي 100% دون اتصال من جانب العميل يحافظ على أمان عقود واجهات برمجة التطبيقات المؤسسية الخاصة

طريقة الاستخدام

  1. 1

    الصق نص `swagger.json` أو `openapi.yaml`، أو ارفع ملف المواصفات مباشرة.

  2. 2

    تصفح توثيق واجهة برمجة التطبيقات المهيكل المعروض في القارئ التفاعلي.

  3. 3

    قم بتوسيع أي نقطة نهاية لفحص ترويسات الطلب ومخططات حمولة الطلب ونماذج الاستجابة.

حالات الاستخدام الشائعة

  • ← تدقيق تعريفات واجهات برمجة التطبيقات الخلفية دون الحاجة إلى تشغيل خادم Swagger UI مخصص
  • ← التحقق السريع من مواصفات OpenAPI المكتوبة يدوياً لرصد مؤشرات `$ref` غير الصالحة
  • ← تزويد مهندسي الواجهات الأمامية بمراجع دقيقة للمخططات أثناء تكامل واجهات برمجة التطبيقات

أدوات ذات صلة

الأسئلة الشائعة والخصوصية

هل يمكن لهذه الأداة قراءة مواصفات YAML مباشرة؟

نعم. يقوم محلل YAML المدمج بمعالجة مواصفات عقود OpenAPI بتنسيقي `.yaml` و `.json` بالكامل داخل المتصفح.

هل يتم رفع مواصفات واجهة برمجة التطبيقات الخاصة بي إلى خوادم خارجية؟

لا. تتم معالجة المستندات وتصيير المخططات حصرياً داخل ذاكرة متصفحك المحلي.