توصيف OpenAPI
يكتب أو يراجع ملف OpenAPI/Swagger لواجهتك مع الأمثلة والنماذج.
توضيح مهم: معظم الاختصارات دي مش أوامر رسمية مبرمجة داخل ChatGPT. هي كلمات بتوجّه الذكاء الاصطناعي لتنفيذ مهمة معينة. بعضها منتشر، وبعضها اختصارات عملية تقدر تستخدمها بنفسك. النتائج ممكن تختلف حسب النموذج، والأفضل تضيف تفاصيل بعد الأمر.
تستخدمه إزاي؟
اكتب الأمر في أول رسالتك للأداة، وبعده طلبك بالتفصيل. الأمر نفسه وطرق كتابته متاحة للمشتركين.
الشرح
«الأمر» يطلب من النموذج كتابة تعريف OpenAPI 3 بصيغة YAML لواجهتك انطلاقًا من وصف المسارات أو من الكود أو من أمثلة الطلبات، مع النماذج المشتركة (components/schemas)، المصادقة، رموز الأخطاء، الترقيم، والأمثلة. كما يمكنه مراجعة تعريف موجود وكشف التناقضات أو الحقول الناقصة. الناتج قابل للتحقق في محرر Swagger ويصلح لتوليد توثيق وعملاء. حدوده: التعريف المولد من وصف عام قد يخالف سلوك الكود الفعلي، فتحقق منه باختبارات عقد (contract tests) أو بتوليده من الكود لاحقًا، وراجع الأمثلة لأنها قد تحمل قيمًا غير واقعية.
طرق الاستخدام والمثال الجاهز للمشتركين
- كل طرق كتابة الأمر ومعنى كل طريقة
- مثال جاهز تنسخه بضغطة وتجرّبه على طول
- نصائح لنتيجة أدق وأوامر مرتبطة
مشترك بالفعل؟ سجّل الدخول