كيفية استخدام مولّد بيانات اختبار API
- صِف الحقول (أو الصق JSON Schema / مخطط OpenAPI) في منطقة الإدخال.
- اختر عدد الصفوف الصالحة التي تحتاجها وصيغة المخرجات وما إذا كنت تريد تضمين المتغيرات الحدّية وغير الصالحة.
- اختيارياً حدّد بذرة (seed) حتى تُولَّد مجموعة البيانات نفسها في كل تشغيل.
- ولّد، وراجع المعاينة وجداول المتغيرات، ثم انسخ الملفات أو نزّلها لمشغّل الاختبارات لديك.
مزايا مولّد بيانات اختبار API
- صِف حقول الطلب بلغة وصف مبسّطة (DSL) بسطر لكل حقل (النوع والإلزامية والحدّ الأدنى/الأقصى والأطوال والقيم المعدودة والنمط) أو الصق JSON Schema أو كائناً نموذجياً أو مستند OpenAPI
- يولّد حتى 1,000 صف صالح بقيم اصطناعية واقعية (عناوين بريد على example.com وتواريخ ومعرّفات UUID وأنماط هواتف) — قابلة لإعادة الإنتاج باستخدام بذرة (seed)
- متغيرات حدّية عند الحدّ الأدنى والأقصى وخطوة واحدة خارج كل حدّ رقمي أو حدّ طول أو حدّ مصفوفة، كل منها موسوم بالنتيجة المتوقّعة
- متغيرات غير صالحة: حقول مطلوبة مفقودة، وأنواع خاطئة، وصيغ سيئة، وقيم خارج النطاق، وأعضاء قيم معدودة غير صالحة، وقيم null، وحقول إضافية
- تصدير الصفوف الصالحة بصيغة JSON أو JSON Lines أو CSV؛ وتصدير جميع المتغيرات معاً بصيغة JSON لمشغّلات الاختبارات المعتمدة على البيانات
- يعمل بالكامل في المتصفح؛ ولا يُرفع أي شيء
مثال على مولّد بيانات اختبار API
مجموعة بيانات تسجيل حساب
الإدخال:
email: email required
age: integer min=18 max=99
plan: enum(free|pro) requiredالنتيجة:
{"email":"harper.reed@example.com","age":31,"plan":"pro"} ← valid row
age = 17 → expected 4xx (minimum − 1 step)
missing "email" → expected 4xx (missing-required)الأسئلة الشائعة حول مولّد بيانات اختبار API
ما الفرق بينه وبين مولّد الحمولات؟
يركّز على مجموعات البيانات: صفوف كثيرة للاختبارات المعتمدة على البيانات، من قائمة حقول أو مخطط، بما في ذلك المتغيرات الحدّية وغير الصالحة.
هل البيانات حقيقية؟
لا — كل شيء بيانات اختبار اصطناعية لا تحاكي أشخاصاً حقيقيين أبداً. تستخدم عناوين البريد نطاقات example.* المحجوزة، والمعرّفات عشوائية.
هل يمكنني التحكم في صيغة المخرجات؟
نعم، تُدعم صيغ JSON وJSON Lines وCSV للصفوف الصالحة؛ وتُعرض المتغيرات كجداول وتُصدَّر معاً بصيغة JSON.
كيف أصف الحقول؟
حقل واحد في كل سطر: "email: email required"، أو "age: integer min=18 max=99"، أو "plan: enum(free|pro) required"، أو "tags: array maxItems=5". ويمكنك بدلاً من ذلك لصق JSON Schema أو كائن نموذجي أو مستند OpenAPI.
ما المتغيرات الحدّية؟
نسخ من حمولة صالحة مع ضبط حقل واحد على حدّه الأدنى وحدّه الأقصى وخطوة واحدة خارج كل حدّ (بما في ذلك minLength/maxLength وmaxItems)، كل منها موسوم بالنتيجة المتوقّعة من واجهة API.
ملاحظات تقنية
تُترجم قائمة الحقول إلى JSON Schema (type وformat وminimum/maximum وminLength/maxLength وenum وpattern وitems) ثم تُغذّى إلى محرّك الحمولات نفسه المستخدم في مولّد حمولات API؛ وتُشتق الصفوف الحدّية من القيود الرقمية وقيود الطول والمصفوفات في ذلك المخطط.