Apidog

منصة تطوير API تعاونية متكاملة

تصميم API

توثيق API

تصحيح أخطاء API

محاكاة API

اختبار API الآلي

طلب اجتياز وهمي لتسريع تصحيح أخطاء واجهة برمجة التطبيقات

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

Amir Hassan

Amir Hassan

Updated on نوفمبر 29, 2024

عند تطوير واجهات برمجة التطبيقات، debugging دائمًا مشكلة مملة.

يمكن أن يساعد Postman في إرسال الطلبات، ولكن عندما يكون جسم واجهة برمجة التطبيقات معقدًا، سيكون من الصعب بناء جسم JSON. يعمل Junit أيضًا، لكن يجب بناء جميع الطلبات بنفسك في فئات الاختبار.

الأجسام المعقدة تجعل العديد من أنظمة الواجهة الخلفية تتخلى عن اختبارات الوحدة وتخرج واجهة برمجة تطبيقات غير مختبرة لمطوري الواجهة الأمامية ومهندسي ضمان الجودة.

توضح الحالة أعلاه أن جودة الكود تنخفض بدون أداة جيدة. والآن، هناك أداة مفيدة تُدعى Apidog يمكن أن تولد جسم الطلب تلقائيًا عند التصحيح. يمكن للأداة بناء طلب JSON صحيح بنفسها.

كيفية محاكاة أجسام الطلبات

تعمل هذه الطريقة لفرق العمل التي تتبنى API أولًا. يتم تصميم واجهات برمجة التطبيقات قبل التطوير، لذا أثناء التصحيح، لديك مواصفة واجهة برمجة التطبيقات.

1. استيراد مواصفات واجهة برمجة التطبيقات إلى Apidog. (كيف تحاكي واجهة برمجة التطبيقات؟ )
2. افتح واجهة برمجة التطبيقات، وتأكد من أن الطلب لديه مواصفة جسم JSON/XML.

وصف الصورة

3. انتقل إلى علامة التبويب "تشغيل"، وانقر على زر "توليد تلقائيًا". لقد حصلت على JSON مزيف وفقًا لمواصفة الطلب!

وصف الصورة

والآن انقر "إرسال" لإرسال الطلب كما فعلت في Postman، ولكن بشكل أكثر كفاءة. تدعم Apidog معظم الميزات الموجودة في Postman. لقد استخدمت فريقنا Apidog لتصحيح واجهات برمجة التطبيقات بدلاً من Postman لأسابيع.

ماذا عن المزيد

لاحظ البيانات المزيفة. تم إنشاؤها تلقائيًا وفقًا لاسم الحقل. يتم محاكاة حقل باسم "مدينة" باسم مدينة، ويتم محاكاة حقل باسم URL الصورة مع URL صورة، وكل البيانات المزيفة تتبع مخطط JSON المحدد في واجهة برمجة التطبيقات. تمامًا مثل المقال السابق: كيفية محاكاة JSON المعقد.

وليس هذا هو النهاية. مرر الماوس فوق السهم بجانب "توليد تلقائيًا"، وسترى ثلاث عناصر قائمة.

عناصر قائمة مزيفة

يعني "تفضيل القيمة الافتراضية أولاً" أن JSON المزيف سيتم ملؤه بالقيمة الافتراضية المحددة في كل حقل من واجهة برمجة التطبيقات أولاً. يعني "تفضيل قيمة المثال أولاً" أن JSON المزيف سيتم تحميله من JSON الطلب المثال أولاً. لكن ماذا يعني "تحديث عند إرسال الطلب"؟

إنه المعنى الحرفي فقط. في كل مرة يتم فيها إرسال الطلب، يتم إنشاء الجسم مرة أخرى.

كيفية تخصيص أجسام الطلبات

حتى الآن، كل شيء يبدو رائعًا. لكن ماذا لو لم يكن من المتوقع أن تتغير بعض حقولي؟ كيف يمكنني جعل بعض الحقول ثابتة وبعضها مزيفًا؟

انقر على زر "القيمة الديناميكية"، وستجد عالمًا جديدًا.

وصف الصورة

جميع بنى Faker.js مدعومة، ويمكنك اختيار أي منها مباشرة. يمكنك حتى اختيار دالة لتحويل القيمة المزيفة مثل md5، substr أو base64، إلخ.
ثم سيتم إدراجها في جسم الطلب، تمامًا مثل هذا.

أجسام الطلبات

يمكنك تحديد أي حقل ثابت وأي حقل مزيف بواسطة Faker.js. عند الإرسال، ستتغير جميع حقول المزيف إلى البيانات الفعلية أدناه.

إعداد المعلمات

هذا كل شيء. ويتغير في كل مرة يتم فيها الإرسال. Apidog أداة رائعة تجعل فريقنا يبني واجهات برمجة التطبيقات بشكل أسرع.