يعمل كل من Apidog CLI و Hoppscotch CLI على تشغيل اختبارات API من الجهاز الطرفي، وكلاهما يتناسب مع مسار CI/CD. ومع ذلك، فإنهما يأتيان من أماكن مختلفة. Hoppscotch هو نظام بيئي مفتوح المصدر لواجهات برمجة التطبيقات (API)، وواجهة سطر الأوامر (CLI) الخاصة به هي أداة تشغيل مجموعات مركزة. Apidog هي منصة API شاملة، وواجهة سطر الأوامر الخاصة بها هي نقطة الدخول الطرفية لسير عمل أكبر لتصميم واجهات برمجة التطبيقات واختبارها ومحاكاتها وتوثيقها.
حكم سريع
- اختر Hoppscotch CLI إذا كان المصدر المفتوح والاستضافة الذاتية هما الأكثر أهمية، وكنت تستخدم Hoppscotch بالفعل، ويغطي تقرير JUnit احتياجاتك من التقارير.
- اختر Apidog CLI إذا كنت تريد تقارير CLI و HTML و JSON، وتشغيلًا مدفوعًا بالبيانات عبر CSV و JSON، وتقارير مستضافة سحابيًا، ومنصة متكاملة خلف واجهة سطر الأوامر.
مقارنة جانبية
| Apidog CLI | Hoppscotch CLI | |
|---|---|---|
| التثبيت | مشغل Apidog / واجهة سطر الأوامر apidog |
npm i -g @hoppscotch/cli (Node v22+) |
| التشغيل | سيناريوهات الاختبار والمجموعات | مجموعات Hoppscotch |
| المصدر | مشروع Apidog، أو استيراد OpenAPI | ملف JSON للمجموعة أو معرف المثيل |
| مدفوع بالبيانات | -d CSV و JSON |
--iteration-data CSV + --iteration-count |
| أدوات إعداد التقارير | CLI، HTML، JSON + رفع سحابي | JUnit XML |
| البرمجة النصية | المعالجات الأولية/اللاحقة، التأكيدات | ما قبل الطلب + pw.test() / pw.expect() |
| فحص المواصفات | لا يوجد أداة تدقيق مستقلة (يتم التحقق عند الاستيراد) | لا (إنه مشغل) |
| الموارد كتعليمات برمجية | نقاط النهاية، المخططات، الفروع، طلبات الدمج | لا |
| مصدر مفتوح | لا (طبقة مجانية) | نعم، قابل للاستضافة الذاتية |
| منصة أوسع | التصميم، المحاكاة، التوثيق، الاختبار في تطبيق واحد | جزء من نظام Hoppscotch البيئي |
التثبيت والتشغيل
يتم تثبيت Hoppscotch CLI من npm ويتطلب Node.js v22 أو أحدث (مستخدمو Node 20 يبقون على CLI v0.26.0):
npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json
يأتي Apidog CLI عبر مشغل Apidog ويصادق باستخدام تسجيل الدخول أو رمز الوصول، ثم يقوم بتشغيل السيناريوهات حسب المعرف:
apidog run -t <scenario-id> -e <env-id> --access-token <token>
لا يوجد أي تثبيت منهما ثقيل. المشكلة الوحيدة هي متطلب Node v22 الصارم لـ Hoppscotch، والذي يسبب مشكلة مع صور CI الأقدم. يغطي دليل تثبيت Apidog CLI إعداد المشغل إذا كنت تبدأ من جديد.
ما يشغله كل منهما
يقوم Hoppscotch CLI بتشغيل مجموعة Hoppscotch. يمكنك إما تمرير ملف JSON لمجموعة محلية أو سحب ملف من مثيل Hoppscotch باستخدام معرف ورمز مميز:
hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com
لكل طلب، يقوم بتشغيل النص البرمجي لما قبل الطلب، ويرسل الطلب، ويقيم النص البرمجي للاختبار باستخدام pw.test() و pw.expect(). ينتج عن التأكيد الفاشل رمز خروج غير صفري.
يقوم Apidog CLI بتشغيل سيناريوهات الاختبار التي تم إنشاؤها في مشروع Apidog الخاص بك، والتي يمكنها ربط الخطوات ومشاركة المتغيرات والتأكيد عبر الاستجابات. نظرًا لأن CLI جزء من المنصة، فإن نفس السيناريوهات التي تصممها وتصححها في التطبيق هي نفسها التي تشغلها في CI؛ لا توجد خطوة تصدير منفصلة. راجع الدليل الكامل لـ Apidog CLI لنموذج السيناريو و اختبار REST API من سطر الأوامر للحصول على تشغيل عملي.
الاختبار القائم على البيانات
تقوم كلتا الأداتين بتكرار اختبار على مجموعة بيانات، وهي الميزة التي تهتم بها معظم الفرق.
hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5
يقبل Apidog مجموعات بيانات CSV و JSON باستخدام -d:
apidog run -t <scenario-id> -d ./users.csv -r cli,html
الفرق العملي هو مرونة التنسيق. يقرأ Hoppscotch ملفات CSV؛ يقرأ Apidog ملفات CSV و JSON، وهو أمر مهم عندما تكون البيانات الثابتة لديك متداخلة أو موجودة بالفعل بتنسيق JSON. يعرض دليل الاختبار القائم على البيانات لـ Apidog CLI أنماط CSV و JSON جنبًا إلى جنب.
إعداد التقارير
هذا هو الفارق الأوضح. يكتب Hoppscotch CLI تقارير JUnit XML:
hopp test ./collection.json --reporter-junit ./report.xml
JUnit مدعوم على نطاق واسع، لذا تعرض معظم أنظمة CI النتائج بشكل طبيعي. لكنه التنسيق المنظم الوحيد الذي تنتجه واجهة سطر الأوامر.
يصدر Apidog CLI تقارير CLI و HTML و JSON، ويمكنه دفع النتائج إلى السحابة للحصول على رابط مستضاف وقابل للمشاركة:
apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report
إذا كنت تريد قطعة أثرية HTML مستقلة لمراجع طلب السحب، أو عنوان URL لتقرير مستضاف لوضعه في قناة Slack، فإن Apidog يغطي تنسيقات أكثر. يشرح دليل تقارير اختبار Apidog CLI كل منها. إذا كان JUnit في لوحة تحكم CI الخاصة بك هو كل ما تحتاجه، فإن Hoppscotch جيد.
المصدر المفتوح والاستضافة الذاتية
هنا يفوز Hoppscotch بشروطه الخاصة. النظام البيئي بأكمله مفتوح المصدر وقابل للاستضافة الذاتية، لذا يمكنك تشغيل الواجهة الخلفية بنفسك والاحتفاظ ببيانات الطلب بعيدًا عن أي سحابة مورد. بالنسبة للفرق التي لديها قواعد صارمة لإقامة البيانات أو تفضل الأدوات المفتوحة، فإن هذا سبب حقيقي ويمكن الدفاع عنه لاختياره. يغطي ملخص بدائل Hoppscotch و Postman مقابل Hoppscotch النظام البيئي الأوسع.
Apidog ليس مفتوح المصدر. لديه طبقة مجانية، ولا يتمحور عرضه حول كونه "أكثر انفتاحًا"؛ بل "أكثر تكاملاً".
ما وراء تشغيل الاختبارات
هذا هو المكان الذي يتوقف فيه Apidog CLI عن كونه مجرد مشغل. فهو يدير موارد API كتعليمات برمجية: استيراد OpenAPI، والعمل مع نقاط النهاية، والمخططات، والبيئات، والفروع، وطلبات الدمج من الجهاز الطرفي. وهذا يجعل CLI جزءًا من سير عمل على غرار Git بدلاً من أمر اختبار لمرة واحدة.
كما أنه الواجهة الطرفية لمنصة كاملة. يدفع نفس المشروع تصميم API، وخوادم المحاكاة، والتوثيق، والاختبارات. يقوم Hoppscotch CLI، حسب تصميمه، بتشغيل المجموعات لا أكثر؛ بينما تجلب التصميم والمحاكاة والتوثيق من مكان آخر.
ملاحظة صريحة: لا يحتوي Apidog CLI على أداة تدقيق مستقلة لـ OpenAPI أو أمر دليل النمط. يتحقق من المواصفات عند الاستيراد، لكنه لا يدققها بالطريقة التي تفعلها أداة تدقيق مخصصة. إذا كان تدقيق المواصفات من الطرفية مطلبًا صارمًا، فلن يكون أي من هذين المشغلين هو أداة التدقيق الخاصة بك؛ بل أداة مثل Redocly CLI أو Spectral. قارن مفاضلات المشغلين في Apidog CLI مقابل Newman.
من يجب أن يختار أي واحد
- مطور فردي أو فريق يفضل المصدر المفتوح، ويستخدم Hoppscotch بالفعل: Hoppscotch CLI. مجاني، قابل للاستضافة الذاتية، JUnit في CI، انتهى الأمر.
- فريق يريد منصة واحدة للتصميم، المحاكاة، التوثيق، والاختبار، مع تشغيل قائم على البيانات عبر CSV/JSON وتقارير HTML/JSON/السحابية: Apidog CLI. قم بتنزيل Apidog واستورد مجموعة موجودة لتجربتها.
- تحتاج فقط إلى تشغيل سريع للمجموعة في CI بدون احتياجات أخرى: كلاهما يعمل؛ اختر بناءً على التطبيق الذي توجد فيه مجموعاتك بالفعل.
الأسئلة الشائعة
- هل يدعم كلاهما الاختبار القائم على البيانات؟ نعم. يستخدم Hoppscotch
--iteration-data(CSV) مع--iteration-count؛ ويستخدم Apidog-dمع CSV أو JSON. - أيهما يقدم تقارير أفضل؟ يكتب Hoppscotch تقارير JUnit XML. ويكتب Apidog تقارير CLI و HTML و JSON، بالإضافة إلى تقارير سحابية مستضافة. إذا كنت بحاجة إلى أكثر من JUnit، فإن Apidog يغطي تنسيقات أكثر.
- هل Hoppscotch CLI مجاني ومفتوح المصدر؟ نعم، وهو قابل للاستضافة الذاتية. تحتوي الوثائق الرسمية و مستودع GitHub على التفاصيل. لدى Apidog طبقة مجانية لكنه ليس مفتوح المصدر.
- هل يمكنني نقل مجموعات Hoppscotch الخاصة بي إلى Apidog؟ نعم. قم بتصدير المجموعة واستيرادها، ثم قم بتشغيلها باستخدام
apidog run. يغطي دليل الترحيل تعيين الأوامر.
يقوم كلا المشغلين بالمهمة الأساسية بشكل جيد. اختر Hoppscotch CLI للمصدر المفتوح والاستضافة الذاتية؛ اختر Apidog عندما تريد أن يكون المشغل جزءًا من منصة API متكاملة مع تشغيل وتقارير أكثر ثراءً تعتمد على البيانات.