قيود Postman Collection Runner: ما الذي تغير وكيفية تجاوزها

ملخص سريع

قامت Postman بتقييد الوصول إلى Collection Runner في خطتها المجانية، مما أوقف تنفيذ الاختبارات الآلية للفرق التي لم تُحدِّث اشتراكها. يؤثر هذا على عمليات تشغيل الاختبارات المحلية، وخطوط أنابيب CI/CD، وأي سير عمل كان يستخدم Runner لتنفيذ الطلبات الجماعية. تشرح هذه المقالة ما الذي تغير، وما الذي تسبب في تعطله عمليًا، وكيف تعمل أداة تشغيل Apidog (Runner) بدون قيود على أي خطة.

مقدمة

كانت Collection Runner من Postman إحدى أكثر ميزاتها استخدامًا. كنت تنشئ مجموعة تضم 50 طلب API، تضغط على "Run Collection"، وتشاهد Postman ينفذها بالتسلسل، مع تمرير المتغيرات بين الطلبات، وتأكيدات الاختبار على كل استجابة، وتقرير ملخص في النهاية. بالنسبة للمطورين الذين يختبرون تدفقات معقدة متعددة الخطوات، كانت هذه الميزة ضرورية.

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

ظهر التأثير بسرعة في سير عمل المطورين. بدأت الفرق التي كانت لديها خطوط أنابيب CI تعتمد على Newman (أداة تشغيل Postman للواجهة السطرية) في الوصول إلى الحدود. ووجد المطورون الذين يقومون بتشغيل اختبارات smoke test قبل النشر في Collection Runner أن الميزة غير نشطة أو محدودة.

ما الذي غيرته Postman في Collection Runner

تُقيد الطبقة المجانية من Postman الآن Collection Runner بطريقتين رئيسيتين:

حدود التشغيل الشهرية. لدى الحسابات المجانية سقف لعدد عمليات تنفيذ Collection Runner التي يمكنهم إجراؤها شهريًا. لم تنشر Postman الرقم الدقيق بوضوح، لكن تقارير المجتمع تشير إلى حوالي 25 عملية تشغيل شهريًا. بالنسبة للمطورين الذين يجرون الاختبارات عدة مرات في اليوم، يتم الوصول إلى هذا الحد في غضون أيام.

قيود Newman CLI. أداة Newman، وهي أداة CLI مفتوحة المصدر تتيح لك تشغيل مجموعات Postman في بيئات الطرفية و CI، كانت تعمل سابقًا مع أي تصدير لمجموعة Postman دون الوصول إلى حدود الخطة. بعد عام 2026، ترتبط بعض ميزات Newman بخطة حساب Postman الخاص بك عند استخدام المجموعات المتزامنة عبر السحابة.

تنفيذ الاختبار بدون كتابة كود. تُظهر واجهة Collection Runner المرئية، والتي يمكن الوصول إليها من الشريط الجانبي، حالة تتطلب دفع اشتراك في الحسابات المجانية بعد الوصول إلى حد التشغيل.

ما هو غير مقيد: تشغيل الطلبات الفردية يدويًا (النقر على "إرسال" لطلب واحد) يظل غير محدود. القيود تستهدف تحديدًا التنفيذ الآلي للدفعات.

ما الذي يتعطل عمليًا

اختبارات smoke test قبل الالتزام وقبل النشر

تقوم العديد من الفرق بتشغيل Collection Runner قبل دمج طلب سحب (PR) أو النشر إلى بيئة التدريج. إذا كان لديك 30 طلبًا في مجموعة اختبارات smoke test، فإن فريقًا من ثلاثة مطورين يقوم كل منهم بتشغيلها مرتين يوميًا سيستنفد الحد الشهري المجاني لـ Postman في حوالي يومين.

خطوط أنابيب CI/CD

تعتبر خطوط أنابيب CI القائمة على Newman هي الأكثر تأثرًا. سير عمل GitHub Actions مثل هذا:

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json

سيبدأ في الفشل أو سيصل إلى أخطاء في معدل الاستخدام بمجرد الوصول إلى حد الحساب. وهذا مدمر بشكل خاص للفرق التي لديها خطوط أنابيب متعددة تُشغَّل عند كل عملية دفع.

مجموعات الاختبار الشاملة

قامت بعض الفرق ببناء سير عمل API متعدد الخطوات في Postman يقوم بربط الطلبات ببعضها البعض، حيث يمرر مخرج طلب واحد (مثل رمز المصادقة) إلى التالي. تتعامل Collection Runner مع هذا من خلال نمط pm.environment.set(). مع تقييد Runner، لا يمكن اختبار سير العمل هذه إلا عن طريق المرور يدويًا عبر الطلبات واحدة تلو الأخرى.

اختبار التحميل والأداء

تتميز Collection Runner من Postman بخيار "التأخير" و"التكرارات" الذي يتيح لك تشغيل مجموعة عدة مرات بالتسلسل، وهو مفيد لاختبار التحميل الأساسي. مع وضع حدود التشغيل، اختفى هذا الاستخدام بشكل فعال في الطبقة المجانية.

حلول بديلة فورية داخل Postman

إذا لم تكن مستعدًا للتبديل إلى أدوات أخرى بعد، توجد بعض الحلول البديلة داخل نظام Postman البيئي.

التصدير إلى Newman والتشغيل محليًا. تعمل Newman مقابل ملف JSON لمجموعة مُصدرة محليًا دون الحاجة إلى تسجيل الدخول إلى حساب Postman، طالما أنك لا تستخدم ميزات تتطلب الاتصال بالخادم. قم بتصدير مجموعتك وبيئتك، ثم قم بتشغيل Newman بالكامل دون اتصال بالإنترنت:

newman run collection.json -e environment.json

يتجاوز هذا حد تشغيل حساب Postman لأن Newman يقرأ ملفًا محليًا. القيد هو أنك تفقد التزامن مع مساحة عمل Postman المباشرة، لذا تحتاج إلى إعادة التصدير في كل مرة تتغير فيها المجموعة.

تقسيم المجموعات الكبيرة إلى أجزاء أصغر. إذا كنت قريبًا من الحد الشهري، فإن تقسيم مجموعة من 100 طلب إلى أربع مجموعات من 25 طلبًا يعني أن كل منها يستخدم عداد تشغيل منفصل. هذا حل مؤقت وليس حلًا، ويقطع التدفق المنطقي للاختبارات متعددة الخطوات.

الترقية بشكل انتقائي. إذا كان عضو واحد فقط في الفريق يدير خط أنابيب CI، فإن جعل هذا الحساب على خطة مدفوعة بينما يظل الآخرون مجانيين هو أرخص من ترقية الجميع. يقوم الحساب المدفوع بتشغيل Newman بدون قيود؛ ويستخدم الآخرون الاختبار اليدوي.

كيف تعمل أداة تشغيل المجموعات (Collection Runner) في Apidog بشكل مختلف

لا تحتوي أداة تشغيل Apidog (التي تسمى "Test Scenarios" أو يمكن الوصول إليها عبر زر "Run" في أي مجموعة) على حدود تشغيل شهرية على أي خطة. يشمل هذا الطبقة المجانية.

وإليك مقارنة لما قيدته Postman:

تتكامل أداة تشغيل Apidog CLI (apidog-cli) مع CI/CD بنفس الطريقة التي تعمل بها Newman. هيكل الأمر مشابه:

apidog run {project-id} --collection {collection-id} --environment {env-id}

يمكنك أيضًا تصدير مجموعة من Apidog وتشغيلها دون اتصال بالإنترنت، على غرار نهج ملف Newman المحلي، ولكن دون الحاجة إلى القلق بشأن القيود القائمة على الحساب.

إعداد Apidog runner في خط أنابيب CI الخاص بك

إذا كنت تقوم بترحيل خط أنابيب قائم على Newman إلى Apidog، فإليك كيف تبدو عملية الانتقال في GitHub Actions.

قبل (Newman):

- name: Install Newman
  run: npm install -g newman

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json --reporters cli,json --reporter-json-export results.json

بعد (Apidog CLI):

- name: Install Apidog CLI
  run: npm install -g apidog-cli

- name: Run API tests
  run: apidog run --project {project-id} --env {env-id} --output results.json
  env:
    APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}

الاختلافات الرئيسية هي آلية المصادقة (يستخدم Apidog رمز وصول بدلاً من مفتاح Postman API) والمرجع القائم على المشروع بدلاً من مسار ملف محلي. يدعم كلاهما إخراج JSON للإبلاغ عن نتائج الاختبار.

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

ميزات Runner المتقدمة في Apidog

بالإضافة إلى مطابقة مجموعة الميزات المقيدة في Postman، تضيف أداة تشغيل Apidog بعض الإمكانيات الجديرة بالمعرفة.

اختبار يعتمد على البيانات. استورد ملف CSV أو JSON إلى عملية تشغيل اختبار لتنفيذ نفس المجموعة ببيانات مختلفة. يصبح كل صف تكرارًا واحدًا. هذا يعادل ميزة ملف البيانات في Postman، والتي تتطلب أيضًا دفع اشتراك في مستويات Postman الأعلى.

عدادات تكرار مخصصة. قم بتعيين عدد محدد من التكرارات لعملية تشغيل الاختبار دون القلق بشأن عداد شهري. قم بتشغيل مجموعتك 500 مرة لاختبار إجهاد أساسي إذا لزم الأمر.

تكامل Smart Mock. أثناء تنفيذ أداة التشغيل، يمكنها التفاعل مع خادم Mock المدمج في Apidog. هذا يعني أنه يمكنك تشغيل الاختبارات مقابل نقاط النهاية الوهمية دون الحاجة إلى تشغيل خادم منفصل، وهو أمر مفيد عند اختبار كود العميل مقابل API لم يتم بناؤه بعد.

عمليات التشغيل المجدولة. قم بإعداد عمليات تشغيل اختبار تلقائية على جدول زمني (كل ساعة، يوميًا، وما إلى ذلك) مباشرة في Apidog دون الحاجة إلى وظائف cron خارجية أو مشغلات CI. تظهر النتائج في سجل اختبار مشروعك.

تُعد قيود Postman’s Collection Runner عائقًا عمليًا للفرق التي بنت خطوط أنابيب CI وسير عمل الاختبارات الآلية على الطبقة المجانية. المسار الأكثر مباشرة للمضي قدمًا هو التبديل إلى أداة تشغيل بدون قيود على الاستخدام. تغطي أداة تشغيل Apidog جميع حالات الاستخدام التي قيدتها الطبقة المجانية من Postman، ويعمل تكامل CLI في إعدادات خط أنابيب CI الحالية مع تغيير بسيط في التكوين.