صندوق أدوات OpenAPI
تحليل OpenAPI/Swagger وcURL الشائعين محليًا في المتصفح، وإنشاء API للعميل، أو Postman، أو JMeter أو OpenAPI JSON.
كيفية استخدام صندوق أدوات OpenAPI
يتم تحليل محتوى OpenAPI وSwagger وcURL في المتصفح الحالي فقط، من دون طلبات بعيدة إلى $ref أو إرسال استدعاءات للواجهات أو رفع المستندات.
استيراد مستند
الصق نص OpenAPI 2/3 JSON، أو YAML أو cURL، ثم اختر وضع التحويل المطلوب.
تشغيل التحويل
بعد النقر على «تشغيل»، اعرض مخرجات العميل أو Postman أو JMeter أو JSON المُطبَّعة؛ سيتوقف التحليل المحلي عند العثور على مفاتيح خطرة.
نتيجة المراجعة
تحقق من عنوان الخادم، والعناصر النائبة للمصادقة، والمعلمات وschema، ثم انسخ النتيجة إلى المشروع لاستخدامها.
القيود والتنبيهات
- لن تُحل مراجع $ref البعيدة عبر الاتصال بالإنترنت؛ يجب تنزيل المستندات التي تتضمن مراجع خارجية وتضمينها أولًا.
- العميل أو المجموعة أو خطة الاختبار المُنشأة هي مسودة ثابتة، ولن تبادر بإرسال طلبات الشبكة نيابةً عن المستخدم.
- سيُرفض تحويل المواصفات شديدة الكِبر أو العمق، أو التي تحتوي على مراجع دائرية أو غير مكتملة؛ ولا تزال المصادقة المعقدة تتطلب استكمالًا يدويًا.
الأسئلة الشائعة
هل سيستدعي API الخاص بي؟
لا، فالصفحة تحلل المستند فقط وتنشئ نصًا.
لماذا لم يتم توسيع المرجع الخارجي $ref؟
للحفاظ على التشغيل الثابت تمامًا والخصوصية والأمان، لن يتم طلب المراجع البعيدة تلقائيًا.
هل يمكن طرح الرمز المُنشأ مباشرةً للاستخدام؟
لا يمكن ضمان ذلك؛ يُرجى أولًا مراجعة المصادقة ومعالجة الأخطاء والمهلة وعنوان الخدمة.