[دليل] كيفية تمرير القيم البوليانية باستخدام بوستمان؟

تتطلب التواصل الفعال بين واجهات برمجة التطبيقات (APIs) وتطبيقات العملاء غالبًا نقل بيانات boolean، التي تمثل القيم الصحيحة أو الخاطئة. في مجال اختبار واجهات برمجة التطبيقات، تمكّن أدوات مثل Postman المطورين من إنشاء وإرسال الطلبات التي تعكس بدقة التفاعلات الواقعية. تتناول هذه الدليل الطرق المحددة لتمرير القيم boolean باستخدام Postman، مما يضمن أن تعمل تكاملات واجهات برمجة التطبيقات كما هو مقصود.

ما هو Postman؟

Postman، منصة شائعة لتطوير واجهات برمجة التطبيقات، تمكن المطورين من تبسيط سير العمل الخاص بهم. تقدم مجموعة شاملة من الوظائف التي تشمل بناء، اختبار، وتوثيق واجهات برمجة التطبيقات. لقد جعلت هذه المرونة Postman الأداة المفضلة للمطورين الذين يواجهون أي تحد على صلة بواجهات برمجة التطبيقات.

ما هي القيم boolean في واجهات برمجة التطبيقات؟

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

أين توجد قيم boolean؟

معلمات الطلب

• المرشحات: غالبًا ما تسمح واجهات برمجة التطبيقات بتصفية البيانات بناءً على معايير محددة. يمكن استخدام القيم boolean لتحديد ما إذا كان يجب تضمين أو استبعاد عناصر معينة، مثل isActive=true لاسترجاع المستخدمين النشطين فقط.
• العلامات: تستخدم بعض واجهات برمجة التطبيقات القيم boolean كعلامات لتمكين/تعطيل الوظائف. على سبيل المثال، قد يقوم debugMode=true بتفعيل التسجيل التفصيلي لمشاكل التصحيح.
• المفاتيح: قد تحتوي بعض نقاط نهاية واجهات برمجة التطبيقات على معلمات boolean اختيارية تعمل كمفاتيح لسلوكيات محددة. تخيل showHiddenFiles=true لتضمين الملفات المخفية في استجابة قائمة الملفات.

بيانات الاستجابة

• مؤشرات الحالة: تستخدم واجهات برمجة التطبيقات عادةً القيم boolean للإشارة إلى نجاح أو فشل العملية. قد تحتوي استجابة على حقل مثل success=true أو error=false.
• التحقق من الوجود: يمكن أن تعيد واجهات برمجة التطبيقات قيم boolean لتأكيد وجود أو غياب البيانات. قد تعيد واجهة برمجة التطبيقات hasData=true إذا كانت هناك نتائج لاستعلام محدد.
• توفر الميزة: قد تستخدم واجهات برمجة التطبيقات القيم boolean للإشارة إلى ما إذا كانت ميزة معينة مفعلة لمستخدم معين أو خطة. قد تشمل الاستجابة hasAdvancedFeatures=true.

أكواد الأخطاء

• رسائل الخطأ التفصيلية: تستخدم بعض واجهات برمجة التطبيقات علامات boolean ضمن أكواد الأخطاء لتوفير مزيد من السياق لمواقف الخطأ. على سبيل المثال، قد يكون isAuthenticationError=true جزءًا من رمز خطأ لتحديد مشكلة المصادقة.

دليل خطوة بخطوة لتمرير القيم boolean في Postman

الخطوة 1 - إنشاء حساب Postman

قم بإنشاء حساب جديد في Postman (فقط إذا لم يكن لديك واحد بالفعل) وابدأ في تنزيل تطبيق Postman على جهازك. يقدم التطبيق ميزات أكثر من نسخته عبر الويب.

الخطوة 2 - إنشاء طلب API جديد على Postman

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

الخطوة 3 - إدخال طريقة واجهة برمجة التطبيقات والتفاصيل

بعد ذلك، تحتاج إلى تضمين تفاصيل طلب واجهة برمجة التطبيقات التي ترغب في إنشائها. يجب أن تشمل مكونات مثل URL، طرق HTTP، ومعلمات إضافية ستحتاجها واجهة برمجة التطبيقات.

الخطوة 4 - افتح قسم سكريبت ما قبل الطلب

على واجهة برمجة التطبيقات المكتملة الخاصة بك، ابحث عن قسم سكريبت ما قبل الطلب، كما هو موضح في الصورة أعلاه.

الخطوة 5 - إدراج الكود الضروري لتضمين القيم boolean

في هذا القسم الفارغ تحت علامة سكريبت ما قبل الطلب، أدخل الأسطر التالية من الكود لتتمكن من تضمين قيمة boolean.

var bool = [true, false];
pm.globals.set('boolVal',  bool[Math.floor(Math.random()*bool.length)]);

"BoolVal": {{boolVal}},

الخطوة 6 - تضمينها في معلمة طلب API التي ترغب في إرسالها

تأكد من تضمين قيمة boolean في قسم المعلمات، كما هو موضح في الصورة أعلاه.

Apidog - إنشاء واجهات برمجة التطبيقات بدون حدود أو قيود

Apidog هي منصة شاملة لتطوير واجهات برمجة التطبيقات مثل Postman. ومع ذلك، توفر Apidog جميع الوظائف لكامل دورة حياة واجهة برمجة التطبيقات - لم يعد المطورون بحاجة لتنزيل أدوات API إضافية.

إنشاء واجهات برمجة التطبيقات من الصفر باستخدام Apidog

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

للبدء، اضغط على زر واجهة برمجة التطبيقات جديدة، كما هو موضح في الصورة أعلاه.

بعد ذلك، يمكنك تحديد العديد من خصائص واجهة برمجة التطبيقات. في هذه الصفحة، يمكنك:

• تحديد طريقة HTTP (GET، POST، PUT، أو DELETE)
• تحديد URL واجهة برمجة التطبيقات (أو نقطة نهاية واجهة برمجة التطبيقات) لتفاعل العميل مع الخادم
• تضمين معلمة واحدة أو أكثر سيتم تمريرها في URL واجهة برمجة التطبيقات
• تقديم وصف لما ستوفره واجهة برمجة التطبيقات من وظائف.

اختر بحرية أنواع بيانات المعلمات باستخدام Apidog

مع Apidog، لا تحتاج لوضع كود إضافي لتمكين القيم boolean. يمكن لـ Apidog تسهيل إرسال القيم boolean في طلب واجهة برمجة التطبيقات.

مع Apidog، يمكنك الاختيار من بين أي نوع بيانات تقريبًا موجود!

الخاتمة

من خلال فهم الطرق المختلفة لتمرير القيم boolean في Postman (JSON وform-data)، يمكنك بناء طلبات تعكس بدقة تفاعلات واجهتك برمجة التطبيقات المرغوبة. تذكر دائمًا استشارة توثيق واجهة برمجة التطبيقات للتحقق من التنسيق المتوقع للبيانات وتمثيل boolean (true/false أو 1/0) لضمان التواصل السلس.

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