أصبحت واجهات برمجة التطبيقات (APIs) عنصرًا حيويًا في تطبيقات الويب والهواتف المحمولة الحديثة. إنها تتيح لأنظمة البرمجيات المختلفة التواصل ومشاركة البيانات بكفاءة. ومع ذلك، فإن اختبار هذه الواجهات قد يكون مهمة صعبة. وهنا تأتي أدوات مثل Postman و APIdog.
تهدف هذه المقالة إلى إرشادك خلال عملية إضافة المتغيرات إلى نص JSON في Postman و APIdog. هذه الميزة القوية يمكن أن تجعل عملية الاختبار الخاصة بك أكثر ديناميكية وكفاءة.
ما هو Postman؟
أولاً وقبل كل شيء، دعنا نتحدث عن Postman. Postman هي أداة شائعة يستخدمها المطورون والمختبرون لتطوير واختبار واجهات برمجة التطبيقات. إنها توفر واجهة سهلة الاستخدام لإرسال الطلبات HTTP ورؤية الاستجابات. ولكن هذا ليس كل شيء! يقدم Postman أيضًا ميزات متقدمة مثل المتغيرات البيئية، ونصوص الطلب المسبق، ونصوص الاختبار، التي سنستكشفها في هذه المقالة.
ما هي المتغيرات؟
في سياق اختبار واجهة برمجة التطبيقات، المتغيرات هي قيم بديلة للبيانات التي يمكن أن تتغير. يتم استخدامها لتخزين ونقل البيانات بين طلبات مختلفة أو أجزاء من طلب. يمكن أن تحتوي المتغيرات على أنواع مختلفة من البيانات، مثل السلاسل، الأرقام، القيم البولينية، أو حتى الكائنات والمصفوفات المعقدة.
تلعب المتغيرات دورًا حيويًا في اختبار واجهات برمجة التطبيقات، مما يعزز الكفاءة وقابلية الصيانة والموثوقية للاختبارات الخاصة بك. إنها أساسية لأي أداة اختبار واجهة برمجة تطبيقات، بما في ذلك Postman و APIdog.
لماذا استخدام المتغيرات في نص JSON؟
استخدام المتغيرات في نص JSON لطلبات واجهة برمجة التطبيقات له عدة مزايا:
- محتوى ديناميكي: تتيح لك المتغيرات إدراج محتوى ديناميكي في طلباتك. هذا مفيد بشكل خاص عندما لا يكون القيمة الدقيقة المطلوبة في نص الطلب معروفة مسبقًا أو تتغير بشكل متكرر.
- اختبار مدفوع بالبيانات: تتيح لك المتغيرات اختبار مدفوع بالبيانات. يمكنك تحديد مجموعة من القيم لمتغير ثم تشغيل نفس الاختبار عدة مرات، في كل مرة مع قيمة مختلفة من المجموعة.
- بيانات مرتبطة بالبيئة: إذا كان لديك بيئات مختلفة (مثل التطوير أو ضبط الجودة أو الإنتاج)، يمكن استخدام المتغيرات للتبديل بين مجموعات مختلفة من البيانات دون تغيير نص الطلب نفسه.
- تقليل التكرار: إذا تم استخدام قيمة في أماكن متعددة داخل طلب، يمكن استخدام متغير لتمثيل تلك القيمة. هذا يقلل من التكرار ويسهل صيانة اختباراتك.
- الأمان: يمكن تخزين البيانات الحساسة مثل مفاتيح واجهة برمجة التطبيقات أو بيانات اعتماد المستخدم في المتغيرات. هذا يحافظ على البيانات الحساسة بعيدًا عن طلباتك ومجموعاتك، مما يحسن أمان اختباراتك.
يمكن أن يجعل استخدام المتغيرات في نص JSON لطلبات واجهة برمجة التطبيقات الخاصة بك اختباراتك أكثر ديناميكية ومرونة وقابلية للصيانة وأمانًا. إنها ممارسة جيدة في اختبار واجهات برمجة التطبيقات يمكن أن توفر لك الوقت وتساعدك في إنشاء اختبارات أكثر موثوقية.
كيفية إضافة المتغيرات إلى نص JSON في Postman
حسنًا، دعنا ننتقل إلى الحدث الرئيسي: إضافة المتغيرات إلى نص JSON في Postman. إليك دليل خطوة بخطوة:
أولاً، تحتاج إلى تحديد متغيرك. يمكنك القيام بذلك في متغيرات البيئة أو المجموعة. للقيام بذلك:
انقر على أيقونة الترس في الزاوية العلوية اليمنى لفتح نافذة إدارة البيئات.
انقر على إضافة لإنشاء بيئة جديدة، أو اختر واحدة موجودة.
في الصف الجديد الذي يظهر، أدخل اسم متغيرك في عمود المتغير
احفظ تغييراتك.
الآن، يمكنك استخدام هذا المتغير في نص JSON الخاص بك. في علامة التبويب الهيئة في طلبك، اختر raw وJSON من قائمة السحب.
في حقل الإدخال النصي، يمكنك الآن الإشارة إلى متغيرك باستخدام بناء الجملة الخاص بالأقواس المضاعفة.
عندما ترسل طلبك، يقوم Postman باستبدال {{myVariable}} بالقيمة التي حددتها في متغيرات البيئة أو المجموعة.
وهذا كل شيء! لقد قمت بنجاح بإضافة متغير إلى نص JSON لطلب Postman.
كيفية إضافة المتغيرات إلى نص JSON في Apidog
Apidog هي منصة متكاملة للتعاون لتوثيق واجهات برمجة التطبيقات، وتصحيح الأخطاء، والمحاكاة، واختبار واجهات برمجة التطبيقات بشكل آلي. تجمع بين أدوات مثل Postman وSwagger وMock وJMeter لمعالجة مشكلة تزامن البيانات بين أنظمة مختلفة باستخدام مجموعة من الأنظمة ومجموعة من البيانات.
إليك بعض الميزات الرئيسية لـ Apidog:
- توثيق واجهة برمجة التطبيقات: بمجرد تعريف مستند واجهة برمجة التطبيقات، يمكن استخدام تصحيح الأخطاء، والمحاكاة، واختبار واجهة برمجة التطبيقات مباشرة دون الحاجة إلى إعادة التعريف.
- تصحيح أخطاء واجهة برمجة التطبيقات: الأداة الخاصة بالتوثيق وتصحيح الأخطاء هي نفسها، مما يضمن التناسق الكامل بين توثيق واجهة برمجة التطبيقات وتطويرها بعد التصحيح.
- محاكاة واجهة برمجة التطبيقات: المحاكاة الذكية تولد تلقائيًا البيانات بناءً على أسماء الحقول، والمحاكاة المتقدمة ترجع بيانات محددة بناءً على الطلبات، ونصوص المحاكاة تعدل البيانات التي تم إرجاعها.
- اختبار واجهة برمجة التطبيقات بشكل آلي: توليد حالات اختبار من واجهات برمجة التطبيقات، إضافة التأكيدات بصريًا، وإنشاء سيناريوهات اختبار مع الفروع والتكرارات بسهولة.
يهدف Apidog إلى حل مشكلة تزامن البيانات عبر أنظمة متعددة. يوفر حلًا فعالًا وفي الوقت المناسب ودقيقًا. إنها مجموعة كاملة من الأدوات التي تربط دورة حياة واجهة برمجة التطبيقات بأكملها، مما يساعد فرق البحث والتطوير على تنفيذ أفضل الممارسات لتطوير واجهة برمجة التطبيقات أولاً.
إنشاء متغيرات: يمكنك إنشاء متغيرات في Apidog عن طريق الذهاب إلى إدارة البيئة (زر الإعدادات في الزاوية العلوية اليمنى من التطبيق) واختيار علامة المتغيرات العالمية.
في الصف الجديد الذي يظهر، أدخل اسم متغيرك في عمود المتغير
في علامة التبويب الهيئة في طلبك، اختر JSON من القائمة.
في حقل الإدخال النصي، يمكنك الآن الإشارة إلى متغيرك باستخدام بناء الجملة الخاص بالأقواس المضاعفة.
هذه هي الطريقة التي يمكنك من خلالها إضافة متغير إلى نص JSON في Apidog.
الخاتمة
إضافة المتغيرات إلى نص JSON في Apidog وPostman هي تقنية قوية يمكن أن تبسط عملية اختبار واجهة برمجة التطبيقات الخاصة بك. لا تجعل اختباراتك أكثر ديناميكية ومرونة فحسب، بل تبسط أيضًا عملية اختبار واجهة برمجة التطبيقات الخاصة بك.
على مدار هذه المقالة، استكشفنا ما هي المتغيرات، ولماذا هي مهمة في اختبار واجهات برمجة التطبيقات، وكيفية إضافتها إلى نص JSON في كل من Postman و APIdog. مع المعرفة والمهارات التي اكتسبتها، أنت الآن مجهز لأخذ اختبار واجهة برمجة التطبيقات الخاصة بك إلى المستوى التالي.
تذكر، الممارسة هي المفتاح عندما يتعلق الأمر بإتقان أي مهارة جديدة. من خلال استخدام المتغيرات، يمكنك إنشاء طلبات أكثر ديناميكية وتقليل التكرار في اختباراتك.