إنتقل إلى المحتوى الرئيسي

البدء السريع

تعبر هذه الجولة الموجزة الحلقة المركزية: فتح مواصفة، وتعديلها بمساعد الذكاء الاصطناعي، وإرسال طلب، ورؤية النتيجة كتوثيق، باستخدام مستند OpenAPI نفسه في كل مكان.

1. فتح مواصفة​

شغّل العميل وافتح مواصفة من أي مصدر مدعوم. تمر جميعها بتدفّق الاستيراد نفسه وتُحوَّل أو تُرقّى إلى OpenAPI 3.2:

  • ملف OpenAPI أو Swagger على القرص (Swagger 2.0، وOpenAPI 3.0 / 3.1 مُرقّاة).
  • مجموعة Postman.
  • أمر cURL.
  • مستودع Git.
  • رابط يشير إلى مواصفة.

يمكنك أيضاً سحب وإفلات ملف مباشرة في مساحة العمل. دون نقطة بداية، اطلب من المساعد إنشاء هيكل أولي من وصف موجز.

2. طلب إضافة نقطة نهاية من المساعد​

في المحادثة، صف ما تحتاجه. مثلاً:

أضف نقطة نهاية GET /products تُرجع قائمة منتجات مُرقّمة صفحات.

لا يعدّل المساعد المستند مباشرة؛ بل يرد بـبطاقة تصحيح. تُظهر البطاقة العملية المراد تعديلها والمسارات/الموارد المتأثرة. راجع، ثم اختر تطبيق أو رفض. لا يصل شيء إلى المستند قبل التطبيق.

لطلب واسع مثل «ابنِ واجهة تجارة إلكترونية»، يطرح المساعد أولاً أسئلة توضيحية ثم يقترح تصحيحات مركّزة على 2 إلى 5 عمليات في كل مرة.

3. صقل عملية واحدة دون انحراف​

افتح العملية وصقّلها في موضعها — أضف معامل استعلام أو وسّع مخطط الاستجابة. في وضع التركيز، يولّد المساعد تصحيحات دقيقة لا تمس إلا الحقول المطلوبة وتحافظ على بقية العملية. هذا يمنع تغيير أو استبدال العمل القائم في التعديلات المتكررة على الواجهة نفسها.

4. إرسال طلب حقيقي​

انتقل إلى مساحة العمل الخاصة بالطلب للعملية وأرسل. يُنفَّذ الطلب عبر العملية المحلية الرئيسية. تظهر الاستجابة والحالة والرؤوس والزمن بجانب العملية، وللقيم التي تتغيّر في كل تشغيل يمكنك استخدام البيئات والمتغيرات.

إذا لم توفّر servers المواصفة ولا البيئة النشطة رابطاً أساسياً، لا يخمّن التطبيق: يطلب إدخال الرابط الأساسي.

5. رؤية التوثيق​

افتح التوثيق: تُعرَض المواصفة نفسها كتوثيق واجهة مقروء. يقرأ العارض المستند الحي، لذا يتطابق التوثيق دائماً مع ما صُمّم تواً.

6. المضي أبعد عند الجاهزية​

بهذا تكتمل الحلقة المركزية. توضّح بقية الوثائق كل مساحة عمل.