لماذا هذا مهم؟
العقود الواضحة لواجهات البرمجة تقلّل الاحتكاك بين الفرق. تستخرج هذه الأداة نقاط النهاية والطرائق والمعاملات والمخططات الأولية من لقطات المرور والأوامر، ثم تنظّمها في وثيقة OpenAPI 3.1 متسقة. يمكنك إثراء النتيجة بوصف وأمثلة سهلة القراءة، جاهزة للتوثيق أو خوادم المحاكاة.
الميزات
- cURL → OpenAPI 3.1 مع تحليل ذكي للأعلام والحمولات.
- HAR → OpenAPI 3.1 مع تجميع المسارات ورصد الاستجابات.
- اقتراحات مخطط من شكل JSON المرصود؛ افتراضات آمنة للمجهول.
- اختياريًا: إزالة التكرار في components وإعادة استخدام المعاملات.
- تصدير كـ YAML أو JSON، جاهز للتحقق ضمن CI.
الأسئلة الشائعة
هل يتعامل مع رؤوس المصادقة؟
نكتشف أنماط المصادقة الشائعة ونضيف مخططات أمان مبدئية قابلة للتنقيح (Bearer، مفتاح API...).
ما مدى دقة المخططات؟
نستنتج JSON Schema محافظة بناءً على الأمثلة؛ ويمكنك ترقية الأنواع وإضافة الصيغ حسب الحاجة.
هل يمكن الاستيراد إلى Swagger UI أو Redoc؟
نعم، المخرجات متوافقة مع أغلب العارضات والمولّدات. نوصي بالتحقق باستخدام spectral أو openapi‑validator.
سير عمل مقترح
- التقط HAR يمثل الطلبات النموذجية أو جهّز مقتطفات cURL.
- ولّد المواصفة الأساسية هنا.
- راجع وأثْرِ الأوصاف والأمثلة ونماذج الأخطاء.
- ادمجها في المستودع واربط CI للتحقق.