Postman، أداة تصحيح واجهات برمجة التطبيقات الشائعة على نطاق واسع، أصبحت أداة لا غنى عنها للمطورين في جميع أنحاء العالم. لقد جعلت واجهتها سهلة الاستخدام وميزاتها القوية الخيار المفضل لاختبار وإدارة واجهات برمجة التطبيقات. ومع ذلك، مثل أي أداة، فإن Postman ليست خالية من القيود.
في هذه التدوينة، سنستكشف بعض العيوب التي قد يواجهها المطورون أثناء استخدام Postman وسنناقش الحلول المحتملة لتجاوز هذه التحديات. لذا دعونا نغوص في عمق الأمور ونكتشف الجوانب الخفية لهذه الأداة المحلية المشهورة!
عيوب Postman
- حدود التشغيل: حتى إذا قمت بشراء النسخة الاحترافية من Postman (بسعر 39 دولارًا لكل مستخدم شهريًا)، فإنك مقيد بتشغيل مجموعة فقط 250 مرة في الشهر. هذه القيود قد تكون غير كافية للأفرقة التي تستخدم الاختبارات التلقائية بشكل مكثف.
- عدم وجود تعاون: يمكنك استخدام Postman لإدارة واجهات برمجة التطبيقات الخاصة بك، ولكنه لا يمتلك أي ارتباط بمجموعاتك. عندما يتعرض API للتغييرات، وهو أمر شائع في المشاريع المرنة، يتعين على كل فرد في الفريق إعادة كتابة جميع الطلبات والاختبارات ذات الصلة يدويًا. يمكن أن يكون هذا تحديًا كبيرًا وصعبًا على الصيانة، خاصةً بالنسبة للمشاريع الأكبر.
- منحنى التعلم الحاد: تتطلب كتابة النصوص الخاصة بالطلب المسبق والاختبارات معرفة تقنية، مما يمكن أن يكون غير مريح للعديد من مهندسي الاختبار. بالإضافة إلى ذلك، فإن النصوص غير قابلة لإعادة الاستخدام بسهولة، مما يزيد من عدم الراحة.
الانتقال من Postman إلى Apidog
يدعم Apidog تقريبا جميع الميزات الأساسية لـ Postman، مما يسمح لك بالانتقال بسهولة من Postman إلى Apidog. الطريقة المحددة هي كما يلي، بالإضافة إلى الدليل من الفيديو.
نقل المجموعات
الخطوة 1. ابحث عن مجموعات Postman، مرر الماوس فوق المجموعة التي تريد تصديرها، انقر على أيقونة ···، اختر "تصدير".
الخطوة 2. ثم اختر تصدير مجموعة v2.1 (موصى به) لتصدير المجموعات. يدعم Apidog استيراد بيانات تنسيق مجموعة Postman v2.1.
الخطوة 3. انقر على "استيراد" في Apidog، اختر "Postman" وارفع ملفًا من التنزيلات. في Apidog، يمكنك استيراد ملف JSON المصدّر من Postman في إعدادات المشروع.
الخطوة 4. رفع مصدر بيانات الناتج من Postman. انقر “تأكيد” كما هو موضح أدناه.
بعد الاستيراد، ستظهر المجموعات في وحدة API الخاصة بـ Apidog، بينما ستظهر الطلبات/الاختبارات التمهيدية تحت نقاط نهاية API.
نقل البيئات
تصدير بيئات Postman:
يتم تخزين بيانات بيئة Postman وبيانات المجموعة بشكل منفصل، لذا ستحتاج إلى تصدير البيئة من Postman عن طريق النقر على "..." بجوار البيئة في Postman، اختيار "تصدير"، وتصدير البيئة.
استيراد بيئة Postman إلى Apidog:
ثم، في واجهة Apidog، انتقل إلى إدارة البيئة في الزاوية العلوية اليمنى، واختر "استيراد بيئة Postman".
ما عليك سوى اختيار ملف البيئة الذي تم تنزيله من Postman ورفعه إلى Apidog. سيسمح لك ذلك باستيراد بيئة Postman بسلاسة إلى Apidog.
يوفر Apidog عملية انتقال سلسة من Postman، مع توافق مع نصوص Postman وميزة استيراد مريحة تتيح لك نقل نصوصك ومشاريعك الحالية دون أي متاعب. مع الوظائف الممتازة لـ Apidog وسهولة الاستخدام، إنه استثمار رائع لأي فريق تطوير API يتطلع إلى تبسيط سير العمل الخاص بهم.
الاختلافات بين Postman وApidog
Apidog مصمم لفرق تطوير واجهات برمجة التطبيقات، حيث يدمج تصميم واجهات برمجة التطبيقات، التطوير، التصحيح، المحاكاة، الاختبار، والتوثيق في منصة واحدة. يوفر بيئة تعاونية مريحة مع واجهة مرئية، مما يقلل بشكل كبير من منحنى التعلم. بالإضافة إلى ذلك، فإن Apidog أكثر تكلفة ولاتوجد به أي قيود على عدد عمليات التشغيل.
يوفر Apidog التوافق مع نصوص Postman ويقدم ميزة استيراد مريحة، مما يسمح بانتقال سلس من Postman إلى Apidog. يمكنك بسهولة نقل نصوصك ومشاريعك الحالية من Postman إلى Apidog دون أي متاعب.
خلال عملية النقل، ستلاحظ بعض الاختلافات في فلسفة التصميم بين Apidog وPostman. فهم هذه الاختلافات سيساعدك على إكمال النقل بنجاح.
المجموعات، حالات API، سيناريوهات الاختبار
عندما يتعلق الأمر بتصحيح واجهات برمجة التطبيقات في Postman، فإن العملية بالكامل تدور حول الطلبات. تقوم بإنشاء الطلبات وتنظيمها ضمن مجموعات للتنفيذ. ومع ذلك، يتخذ Apidog نهجًا مختلفًا. ستلاحظ أنه لا يحتوي على مفهوم المجموعات. تنبع هذه الانحرافات من منطق Apidog، الذي يعتبر جميع الطلبات مخصصة لـ API معين. لذلك، يجب تنظيم الطلبات تحت واجهات برمجة التطبيقات الخاصة بها، مع توفر عدة حالات طلب لكل واجهة برمجة تطبيقات.
عندما تنتقل من Postman إلى Apidog، يتحول الطلب من Postman إلى حالة API في Apidog. ستلاحظ حالة "نجاح" في كل API، حيث تصبح نصوص الطلب المسبق والاختبارات جزءًا من حالة API. تسمح لك هذه إعادة التنظيم في Apidog بإدارة الطلبات داخل الإطار الأوسع لواجهة برمجة التطبيقات بشكل أفضل.
عندما تحتاج إلى تشغيل مجموعة في Apidog، يمكنك استخدام وحدة الاختبارات التلقائية. هنا، يمكنك الإشارة إلى حالات API وإنشاء سيناريو اختبار من خلال تجميعها معًا للتنفيذ. ستكون النتيجة تقرير اختبار شامل مشابه لما لديك في Postman.
يوفر هذا النهج العديد من الفوائد. أولاً، يمكن الإشارة إلى حالة API في عدة سيناريوهات اختبار، مما يلغي الحاجة إلى تكرار الطلبات. ثانيًا، ستظهر أي تغييرات تمت على تعريف API مباشرة في كل من حالة API وسيناريو الاختبار المقابل. يحل ذلك التحدي التعاوني الذي ينشأ عندما تتعرض الواجهات للتعديلات.
يأخذ Apidog خطوة إضافية من خلال دعم العبارات الشرطية والحلقات داخل سيناريوهات الاختبار. مع هذه الميزة، يمكنك ترتيب وإعداد حالات API الخاصة بك بطريقة أكثر بديهية وقوة. يوفر المزيد من المرونة وسهولة الاستخدام مقارنة بنهج المجموعات المعتمد في Postman.
البيئات والخدمات
تمتلك العديد من الشركات بيئات متعددة، وفي Postman، يتم التبديل بين البيئات المختلفة غالبًا باستخدام متغيرات البيئة الموضوعة في بداية الروابط. ومع ذلك، فإن هذا النهج لا يعتبر أنيقًا. إنه يجعل رابط الطلب ورابط API مختلفين، ويمزج أيضًا بين تكوينات ومتغيرات البيئة معًا.
في Apidog، يُطلق على ما يعادل رابط البادئة "الخدمة"، والتي يمكن تكوينها ضمن كل API أو مجلد API. يمكن أن تحتوي كل خدمة على قيم مختلفة لبيئات مختلفة، مما يسمح بالتبديل السلس بين البيئات.
علاوة على ذلك، يمكن أن تتضمن البيئة في Apidog عدة خدمات. قد تتطلب بعض واجهات برمجة التطبيقات إرسال الطلبات إلى user.xxx.com، بينما قد تحتاج الأخرى إلى طلب order.xxx.com. من خلال تكوين مجموعة من الخدمات داخل كل بيئة، يمكنك تنظيم وتنفيذ نقاط نهاية API بكل سهولة مع روابطها البادئة المقابلة.
استنادًا إلى هذه الوظائف، يوفر Apidog أيضًا بيئتين خاصتين:بيئة المحاكاة المحلية و بيئة المحاكاة السحابية. مع هذه البيئات المحاكية، لم تعد بحاجة إلى إعداد خادم محاكاة منفصل. من خلال إرسال الطلبات إلى بيئة المحاكاة المعينة، يستجيب الخادم الذكي المدمج في Apidog بشكل ذكي مع ردود API المحددة في تعريفات واجهتك. يتيح ذلك لمطوري الواجهة الأمامية استخدام بيئة المحاكاة بسهولة لتطوير الواجهة حتى قبل اكتمال تطوير واجهة برمجة التطبيقات.
النصوص وعمليات المعالجة قبل/بعد
في Postman، يعتبر كتابة النصوص ضروريًا لكل من الطلب المسبق والاختبارات، مما قد يكون تحديًا لبعض مهندسي ضمان الجودة. ومع ذلك، في Apidog، يتم توفير مجموعة من المعالجات البصرية سهلة الاستخدام، مما يسهل على أي شخص البدء.
أولاً، يدعم Apidog الاستخدام المباشر لنصوص Postman. يمكنك تشغيلها مباشرة في قسم "النص المخصص" أو الإشارة إليها في قسم "النصوص العامة".
ثانيًا، يقدم Apidog assertions بصرية واستخراج متغيرات. مع سهولة إنشاء تعبيرات JsonPath، يمكنك بسهولة استرداد أي عنصر من الاستجابة وإجراء assertions أو تخزينها كمتغير، كل ذلك دون كتابة كود.
ثالثًا، يدعم Apidog عمليات قاعدة البيانات. يمكنك استعلام قاعدة بيانات في المعالجات الأولية لاسترداد القيم كمعلمات طلب، أو إجراء assertions من خلال استعلام قاعدة البيانات في المعالجات النهائية. تدعم قواعد البيانات الشائعة مثل MySQL، Oracle، SQL Server، PostgreSQL، وClickHouse لعمليات القراءة والكتابة على حد سواء.
