العودة للأدوات العامة

استكشاف مواصفة OpenAPI

تصفح مواصفة OpenAPI 3.0 محلية بصيغة JSON أوYAML وحضّر أمثلة curl وJavaScript وPython دون إرسال طلبات.

اختر ملف OpenAPI محليًا بصيغة JSON أو YAML. تصفح العمليات وحضّر أمثلة شفرة دون الاتصال بواجهة API الموصوفة.

يدعم جزءًا من OpenAPI 3.0.x: المراجع المحلية ومخططات الكائنات والمصفوفات والقيم الأولية والحقول المطلوبة وallOf وoneOf وanyOf وnullable والتعدادات والحدود الشائعة. يُرفض Swagger 2 وOpenAPI 3.1+. الحدود: 2 ميغابايت و500 عملية و30,000 قيمة و50 مستوى مصدر وثلاث ثوانٍ لكل مهمة. تُعطل أسماء YAML المستعارة والوسوم المخصصة.

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

افتح أو الصق OpenAPI 3.0.x بصيغة JSON/YAML. صفِّ بالبحث والوسم، واختر عملية وراجع المعلمات ومخططات الجسم والاستجابات والمصادقة والملاحظات. اختر خادمًا معلنًا أو أدخل عنوان HTTP/HTTPS مطلقًا بعد استبدال العناصر النائبة. عدّل القيم والجسم واختر وسيطًا معلنًا وأنشئ الأمثلة للتحقق من القيم المدعومة. راجع الأخطاء والإخفاء ثم انسخ أو نزّل curl أوJavaScript fetch أوPython requests، أو ملخص العملية الأصلي. لا تُرسل طلبات API ولا تُنفذ شفرة.

مثال

جرّب المواصفة الخيالية. اختر GET وراجع معلمات المسار والاستعلام واستبدل قيم المثال. أنشئ كل لغة وراجع العنوان وعناصر بيانات الاعتماد النائبة. اختر عملية ذات جسم وبدّل الوسائط المعلنة لتحديث الأمثلة. اترك قيمة مطلوبة فارغة لرؤية الخطأ المترجم. الخادم .invalid والأمثلة للمراجعة فقط؛ لا يُرسل شيء.

حول هذه الأداة

تبقى الملفات على جهازك. يدعم جزءًا محدودًا من OpenAPI 3.0.x ويرفض Swagger 2 وOpenAPI 3.1+. الحدود: 2 ميغابايت UTF-8 و500 عملية و30,000 قيمة و50 مستوى وثلاث ثوانٍ لكل مهمة. تُعطل أسماء YAML المستعارة والوسوم المخصصة. تُحل المراجع المحلية فقط بحدود للدورات والعمق؛ ولا تُحمّل البعيدة. تُفحص الكائنات والمصفوفات والقيم الأولية والحقول المطلوبة وallOf/oneOf/anyOf وnullable والتعدادات والحدود الشائعة. القيود غير المدعومة والأمثلة العودية تحتاج مراجعة يدوية، ولا تُتحقق جميع تعليقات التنسيق. تدعم الشفرة المسار/الترويسة البسيطة واستعلام form أوdeepObject مسطحًا وملفات الارتباط الأولية وأجسام JSON وtext/plain وURL-encoded وmultipart البسيطة. تفشل البنى المتداخلة وmatrix/label وallowReserved والترميزات المخصصة والوسائط غير المتوافقة صراحةً. حد الجسم 500 كيلوبايت والمعلمات 10,000 حرف. لا تُطلب بيانات اعتماد ولا تُحفظ. تستخدم عناصر نائبة للاعتماد/الملفات وأول بديل أمان. يشمل الإخفاء الأسرار الشائعة وملفات الارتباط وأسماء مفاتيح API المعلنة؛ راجع غيرها قبل المشاركة. استبدل العناصر وراجع الشفرة بنفسك. المراجعة البنيوية ليست شهادة امتثال كاملة أو اختبار خادم مباشر.

Stars and feedback

Loading…

مرجع الأداة #225