Kedua CLI Apidog dan CLI Hoppscotch menjalankan pengujian API dari terminal, dan keduanya cocok untuk pipeline CI/CD. Namun, keduanya berasal dari tempat yang berbeda. Hoppscotch adalah ekosistem API sumber terbuka, dan CLI-nya adalah *runner* koleksi yang terfokus. Apidog adalah platform API lengkap, dan CLI-nya adalah titik masuk terminal untuk alur kerja desain-uji-mock-dokumen yang lebih besar.
Keputusan cepat
- Pilih Hoppscotch CLI jika sumber terbuka dan hosting mandiri paling penting, Anda sudah menggunakan Hoppscotch, dan laporan JUnit memenuhi kebutuhan pelaporan Anda.
- Pilih Apidog CLI jika Anda menginginkan laporan CLI, HTML, dan JSON, eksekusi berbasis data melalui CSV dan JSON, laporan yang di-host di cloud, dan platform terintegrasi di balik CLI.
Perbandingan berdampingan
| Apidog CLI | Hoppscotch CLI | |
|---|---|---|
| Instalasi | Apidog runner / apidog CLI |
npm i -g @hoppscotch/cli (Node v22+) |
| Menjalankan | Skenario dan koleksi pengujian | Koleksi Hoppscotch |
| Sumber | Proyek Apidog, atau impor OpenAPI | File JSON Koleksi atau ID instans |
| Berbasis data | -d CSV dan JSON |
--iteration-data CSV + --iteration-count |
| Pelapor | CLI, HTML, JSON + unggah cloud | JUnit XML |
| Scripting | Pre/post-processor, assertions | Pre-request + pw.test() / pw.expect() |
| Linting spesifikasi | Tidak ada linter mandiri (memvalidasi saat impor) | Tidak (ini adalah runner) |
| Sumber daya sebagai kode | Endpoint, skema, cabang, permintaan penggabungan | Tidak |
| Sumber terbuka | Tidak (tingkatan gratis) | Ya, dapat di-host sendiri |
| Platform yang lebih luas | Desain, mocking, dokumen, pengujian dalam satu aplikasi | Bagian dari ekosistem Hoppscotch |
Instalasi dan waktu proses
Hoppscotch CLI diinstal dari npm dan membutuhkan Node.js v22 atau yang lebih baru (pengguna Node 20 tetap menggunakan CLI v0.26.0):
npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json
Apidog CLI hadir melalui Apidog runner dan melakukan autentikasi dengan login atau token akses, kemudian menjalankan skenario berdasarkan ID:
apidog run -t <scenario-id> -e <env-id> --access-token <token>
Tidak ada instalasi yang berat. Satu kendala adalah persyaratan keras Hoppscotch untuk Node v22, yang menjadi masalah pada image CI yang lebih lama. Panduan instalasi Apidog CLI mencakup pengaturan runner jika Anda memulai dari awal.
Apa yang dijalankan masing-masing
Hoppscotch CLI menjalankan koleksi Hoppscotch. Anda dapat meneruskan file JSON koleksi lokal atau menariknya dari instans Hoppscotch berdasarkan ID dengan token:
hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com
Untuk setiap permintaan, ia menjalankan skrip pra-permintaan, mengirim permintaan, dan mengevaluasi skrip pengujian dengan pw.test() dan pw.expect(). Sebuah penegasan yang gagal akan menghasilkan kode keluar non-nol.
Apidog CLI menjalankan skenario pengujian yang dibangun di proyek Apidog Anda, yang dapat merangkai langkah-langkah, berbagi variabel, dan menegaskan respons. Karena CLI adalah bagian dari platform, skenario yang sama yang Anda rancang dan debug di aplikasi adalah yang Anda jalankan di CI; tidak ada langkah ekspor terpisah. Lihat panduan lengkap Apidog CLI untuk model skenario dan uji REST API dari baris perintah untuk eksekusi langsung.
Pengujian berbasis data
Kedua alat mengulang pengujian pada dataset, yang merupakan fitur yang paling diperhatikan oleh sebagian besar tim.
Hoppscotch menggunakan data iterasi CSV ditambah hitungan:
hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5
Apidog menerima dataset CSV dan JSON dengan -d:
apidog run -t <scenario-id> -d ./users.csv -r cli,html
Perbedaan praktisnya adalah fleksibilitas format. Hoppscotch membaca CSV; Apidog membaca CSV dan JSON, yang penting ketika fixture Anda bersarang atau sudah berupa JSON. Panduan pengujian berbasis data Apidog CLI menunjukkan pola CSV dan JSON secara berdampingan.
Pelaporan
Ini adalah perbedaan yang paling jelas. Hoppscotch CLI menulis JUnit XML:
hopp test ./collection.json --reporter-junit ./report.xml
JUnit didukung secara luas, sehingga sebagian besar sistem CI menampilkan hasilnya secara asli. Namun, ini adalah satu-satunya format terstruktur yang dihasilkan CLI.
Apidog CLI mengeluarkan laporan CLI, HTML, dan JSON, dan dapat mendorong hasil ke cloud untuk tautan yang di-host dan dapat dibagikan:
apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report
Jika Anda menginginkan artefak HTML mandiri untuk peninjau PR, atau URL laporan yang di-host untuk ditempatkan di saluran Slack, Apidog mencakup lebih banyak format. Panduan laporan pengujian Apidog CLI menjelaskan masing-masing. Jika JUnit ke dasbor CI Anda adalah semua yang Anda butuhkan, Hoppscotch baik-baik saja.
Sumber terbuka dan hosting mandiri
Di sini Hoppscotch menang dengan caranya sendiri. Seluruh ekosistemnya adalah sumber terbuka dan dapat di-host sendiri, sehingga Anda dapat menjalankan backend sendiri dan menjaga data permintaan dari cloud vendor mana pun. Bagi tim dengan aturan residensi data yang ketat atau preferensi untuk alat sumber terbuka, itu adalah alasan nyata dan dapat dipertahankan untuk memilihnya. Ikhtisar alternatif Hoppscotch dan Postman vs Hoppscotch mencakup ekosistem yang lebih luas.
Apidog bukanlah sumber terbuka. Ia memiliki tingkatan gratis, dan tawarannya bukanlah "lebih terbuka"; melainkan "lebih terintegrasi."
Melampaui pengujian
Di sinilah Apidog CLI berhenti menjadi sekadar runner. Ia mengelola sumber daya API sebagai kode: mengimpor OpenAPI, dan bekerja dengan endpoint, skema, lingkungan, cabang, dan permintaan penggabungan dari terminal. Itu membuat CLI menjadi bagian dari alur kerja gaya Git daripada perintah pengujian sekali jalan.
Ini juga merupakan antarmuka terminal dari platform lengkap. Proyek yang sama mendorong desain API, server tiruan, dokumentasi, dan pengujian. Hoppscotch CLI, secara desain, menjalankan koleksi dan tidak lebih; Anda membawa desain, mocking, dan dokumen dari tempat lain.
Catatan jujur: Apidog CLI tidak memiliki linter OpenAPI mandiri atau perintah panduan gaya. Ia memvalidasi spesifikasi saat impor, tetapi tidak melakukan linting seperti linter khusus. Jika linting spesifikasi terminal adalah persyaratan yang sulit, tidak satu pun dari runner ini adalah linter Anda; alat seperti Redocly CLI atau Spectral adalah linternya. Bandingkan trade-off runner di Apidog CLI vs Newman.
Siapa yang harus memilih yang mana
- Pengembang solo atau tim yang mengutamakan sumber terbuka, sudah menggunakan Hoppscotch: Hoppscotch CLI. Gratis, dapat di-host sendiri, JUnit ke CI, selesai.
- Tim yang menginginkan satu platform untuk desain, mocking, dokumen, dan pengujian, dengan eksekusi berbasis data melalui CSV/JSON dan laporan HTML/JSON/cloud: Apidog CLI. Unduh Apidog dan impor koleksi yang ada untuk mencobanya.
- Hanya perlu eksekusi koleksi cepat di CI tanpa kebutuhan lain: keduanya berfungsi; pilih berdasarkan aplikasi tempat koleksi Anda sudah ada.
FAQ
Apakah keduanya mendukung pengujian berbasis data? Ya. Hoppscotch menggunakan --iteration-data (CSV) dengan --iteration-count; Apidog menggunakan -d dengan CSV atau JSON.
Mana yang memiliki laporan lebih baik? Hoppscotch menulis JUnit XML. Apidog menulis laporan CLI, HTML, dan JSON, ditambah laporan cloud yang di-host. Jika Anda membutuhkan lebih dari JUnit, Apidog mencakup lebih banyak format.
Apakah Hoppscotch CLI gratis dan sumber terbuka? Ya, dan dapat di-host sendiri. Dokumentasi resmi dan repositori GitHub memiliki detailnya. Apidog memiliki tingkatan gratis tetapi bukan sumber terbuka.
Bisakah saya memindahkan koleksi Hoppscotch saya ke Apidog? Ya. Ekspor koleksi dan impor, lalu jalankan dengan apidog run. Panduan migrasi mencakup pemetaan perintah.
Kedua runner menjalankan tugas inti dengan baik. Pilih Hoppscotch CLI untuk sumber terbuka dan hosting mandiri; pilih Apidog jika Anda ingin runner menjadi bagian dari platform API terintegrasi dengan eksekusi dan laporan berbasis data yang lebih kaya.