كيفية استخدام مواصفة API ← حالات اختبار بالذكاء الاصطناعي
- افتح الأداة والصق مقطعاً من OpenAPI أو وصفاً لنقاط النهاية لديك.
- أضف سياقاً اختيارياً (وصف الميزة، ومعايير القبول، والبيئة) — فكلما كان الإدخال أكثر تحديداً كانت النتيجة أفضل.
- حدّد الخيارات (العدد، ولغة الإخراج، ومجال التركيز) ثم اضغط زر التنفيذ.
- راجع النتيجة المنظّمة في الجدول، ثم انسخها أو نزّلها بصيغة Markdown أو CSV أو JSON.
مزايا مواصفة API ← حالات اختبار بالذكاء الاصطناعي
- يفهم مقاطع OpenAPI 3 / Swagger 2 (بصيغة JSON أو YAML) وأوصاف نقاط النهاية بالنص العادي
- حالات لكل عملية مع الطلب (الطريقة والمسار والترويسات والاستعلام والجسم) والحالة المتوقّعة والتأكيدات (assertions)
- محدّد التركيز: الكل، أو إيجابية، أو سلبية، أو مصادقة، أو قيم حدّية، أو أمنية
- جدول بالعمليات المكتشفة إضافة إلى تصدير Markdown/CSV/JSON
- اختر الإنجليزية أو العربية أو الهندية للنص المولَّد — وتبقى المعرّفات وطرق HTTP والرموز التقنية بالإنجليزية دائماً.
مثال على مواصفة API ← حالات اختبار بالذكاء الاصطناعي
المواصفة ← اختبارات API
الإدخال:
DELETE /lookups/{lookup}/values/{id} → 204 / 403 / 409النتيجة:
API-1 Delete unreferenced value → 204
API-2 Delete as Viewer → 403
API-3 Delete referenced value → 409 with reference count
…الأسئلة الشائعة حول مواصفة API ← حالات اختبار بالذكاء الاصطناعي
هل تحتاج الأداة إلى ملف OpenAPI كامل؟
لا. يكفي مقطع يضم بضعة مسارات أو حتى وصف بنص عادي لنقاط النهاية؛ ويعرض الذكاء الاصطناعي العمليات التي اكتشفها حتى تتمكن من تأكيد النطاق.
هل يُخزَّن إدخالي؟
لا. يُرسل نصك إلى خدمة الذكاء الاصطناعي من متقن وتُعاد النتيجة المنظّمة إلى متصفحك. لا نخزّن الموجّهات (prompts) ولا المخرجات — فقط عدّادات استخدام مجهولة الهوية تُستخدم للحدود اليومية.
كم عملية توليد يمكنني تشغيلها؟
يحصل الزوار المجهولون على حصة يومية صغيرة لكل عنوان شبكة؛ ويحصل المستخدمون المسجّلون على حصة يومية أعلى. ويُعرض العدد المتبقي أسفل كل نتيجة.
هل يمكنني الحصول على النتيجة بالعربية أو الهندية؟
نعم — اختر لغة الإخراج. تُكتب حقول اللغة الطبيعية بتلك اللغة، بينما تبقى المعرّفات وطرق HTTP والمسارات وسائر الرموز التقنية بالإنجليزية.
ملاحظات تقنية
يُرسل إدخالك إلى خدمة الذكاء الاصطناعي من متقن من خلال اتصال مشفّر؛ ولا تُخزَّن الموجّهات (prompts) ولا النتائج أبداً — فقط عدّادات استخدام مجهولة الهوية تُستخدم لتحديد معدّل الطلبات.
يجب أن يجيب الذكاء الاصطناعي بصيغة JSON صارمة يُتحقَّق منها مقابل مخطط (schema) على الخادم قبل عرض أي شيء؛ وتُعاد محاولة الإجابات المشوّهة مرة واحدة ثم تُرفض مع رسالة واضحة.
لا يختلق الذكاء الاصطناعي أبداً نقاط نهاية غير موجودة في العقد؛ وعندما تكون المواصفة غامضة يسجّل حقل الملاحظات الافتراض المعتمد.