Alat CLI Ringan Terbaik untuk Mocking API

Anda membutuhkan API palsu untuk pengembangan, dan Anda membutuhkannya dalam tiga puluh detik berikutnya. Bukan layanan yang di-hosting, bukan tumpukan Docker Compose, bukan GUI untuk diklik. Cukup perintah yang membaca file dan mulai melayani respons di localhost.

Itulah yang dilakukan server mock ringan. Anda mengarahkannya ke spesifikasi OpenAPI atau file data kecil, menjalankan satu perintah, dan mendapatkan endpoint realistis yang dapat diakses oleh frontend atau pengujian Anda saat backend yang sebenarnya masih dibangun. Yang terbaik tersedia sebagai biner tunggal atau paket yang dapat di-npx, mulai dalam waktu kurang dari satu detik, dan hampir tidak memerlukan konfigurasi. Beberapa opsi yang lebih berat di sini berjalan di JVM dan melakukan lebih banyak; mereka mendapatkan tempatnya ketika Anda membutuhkan pencocokan permintaan tingkat lanjut atau perilaku stateful.

Panduan ini memberi peringkat enam mocker CLI berdasarkan seberapa sedikit yang mereka minta dari Anda. Ini dimulai dengan yang dapat Anda jalankan tanpa menginstal apa pun, kemudian membahas server JVM mandiri, dan diakhiri dengan rute terintegrasi melalui Apidog CLI. Setiap perintah instal dan perintah mock di bawah ini diperiksa terhadap dokumen resmi setiap alat. Jika Anda menginginkan bidang yang lebih luas di luar baris perintah, rangkuman alat mock API terbaik juga mencakup opsi GUI dan yang di-hosting.

Apa yang membuat alat mock CLI "ringan"

Ringan adalah tentang jejak dan gesekan, bukan jumlah fitur. Saat Anda membandingkan alat-alat ini, pertimbangkan empat hal:

• Ukuran instalasi dan waktu proses. Paket pure-Node yang dapat Anda npx memiliki berat beberapa megabyte. Server JVM mandiri adalah file jar 20MB+ yang membutuhkan runtime Java. Keduanya valid; mereka berada di ujung yang berbeda dari daftar ini.
• Kecepatan startup. Server mock yang baik sudah berjalan sebelum Anda beralih kembali ke editor Anda. Alat berbasis Node memulai dari dingin dalam waktu kurang dari satu detik.
• Konfigurasi ke respons pertama. Bisakah Anda beralih dari nol ke endpoint langsung dengan satu file dan satu perintah? Alat teringan mengatakan ya.
• Mengutamakan terminal. Tanpa akun, tanpa dasbor, tanpa langkah GUI dalam loop. Alat membaca file dan melayaninya, dan cocok dalam skrip shell atau tugas CI.

Alat diurutkan dari yang terkecil dan tercepat terlebih dahulu. Prism, Mockoon CLI, dan json-server adalah yang dapat Anda jalankan dengan npx dan tanpa instalasi global.

Prism (Stoplight)

Prism mengubah file OpenAPI menjadi server mock langsung dengan satu perintah. Jika Anda sudah memiliki spesifikasi, ini adalah mock dengan upaya terendah dalam daftar; ia membaca paths, examples, dan skema Anda dan melayani respons yang sesuai.

npx @stoplight/prism-cli mock ./openapi.yaml

Itu memulai server di http://127.0.0.1:4010 dengan setiap operasi dalam spesifikasi Anda terhubung. Prism mengembalikan example yang Anda definisikan untuk respons, atau menghasilkan respons acak yang valid dari skema jika Anda tidak mendefinisikannya. Ini juga memvalidasi permintaan masuk terhadap spesifikasi, sehingga panggilan yang salah format mendapatkan 422 yang tepat alih-alih melewati secara diam-diam. Untuk instalasi global, gunakan npm install -g @stoplight/prism-cli dan hilangkan npx.

Terbaik untuk: tim yang mengutamakan spesifikasi yang ingin mock tetap sesuai dengan kontrak. Prism dilisensikan di bawah Apache-2.0 dan mendukung OpenAPI 3.1, 3.0, 2.0, dan koleksi Postman.

Batasan jujur: Prism adalah stateless. Sebuah POST tidak mempertahankan apa pun, jadi itu tidak akan memalsukan alur create-then-read. Mocknya hanya sebaik spesifikasi Anda; contoh yang tipis berarti respons yang tipis. Untuk mocking yang akurat secara kontrak, itulah intinya, dan itu sangat cocok dengan alur kerja alat mocking REST API.

Mockoon CLI

Mockoon CLI menjalankan API mock dari file data, baik yang Anda ekspor dari aplikasi desktop Mockoon gratis atau spesifikasi OpenAPI biasa. Aplikasi desktop memungkinkan Anda membangun rute secara visual; CLI menjalankan lingkungan yang sama secara headless di CI atau di server.

npx @mockoon/cli start --data ./mockoon-env.json --port 3000

Arahkan --data ke file lingkungan Mockoon atau file JSON/YAML OpenAPI dan itu segera melayani. Jika file data berasal dari versi Mockoon yang lebih lama, CLI memigrasikannya dalam memori tanpa menyentuh aslinya. Instal secara global dengan npm install -g @mockoon/cli jika Anda lebih suka perintah mockoon-cli yang persisten.

Terbaik untuk: tim yang ingin mendesain mock di GUI tetapi menjalankannya secara headless. Ini dilisensikan MIT dan memiliki citra Docker resmi untuk deployment.

Batasan jujur: rute terkaya dibangun di aplikasi desktop, jadi mengedit file lingkungan JSON secara manual itu rumit. Jika Anda tidak menginginkan aplikasi pendamping sama sekali, Prism atau json-server menyimpan semuanya dalam satu file yang Anda tulis sendiri.

json-server

json-server adalah cara tercepat untuk memalsukan REST API ketika Anda belum memiliki spesifikasi. Anda menulis file JSON biasa yang menjelaskan data Anda, dan itu menghasilkan REST API lengkap di sekitarnya, lengkap dengan GET, POST, PUT, PATCH, dan DELETE.

echo '{ "posts": [{ "id": 1, "title": "hello" }] }' > db.json
npx json-server db.json

Itu melayani http://localhost:3000/posts dengan CRUD nyata. Sebuah POST ke /posts benar-benar menambahkan catatan dan menuliskannya kembali ke db.json, sehingga Anda mendapatkan perilaku stateful secara gratis, yang tidak akan diberikan oleh Prism dan WireMock secara langsung. Anda juga mendapatkan pemfilteran, pengurutan, dan paginasi melalui parameter kueri. Baris 1.x saat ini mengamati file dan memuat ulang pada perubahan secara default; instal secara global dengan npm install -g json-server jika Anda ingin itu selalu ada di PATH Anda.

Terbaik untuk: pengembang frontend yang membutuhkan backend REST yang berfungsi dalam satu menit, sebelum API yang sebenarnya ada. Ini dilisensikan MIT dan salah satu opsi server mock ringan untuk RESTful API yang tidak membutuhkan spesifikasi sama sekali.

Batasan jujur: ini mengasumsikan bentuk REST gaya sumber daya. Rute yang sangat kustom, endpoint non-REST, atau pencocokan header yang ketat berada di luar apa yang dilakukannya dengan bersih. Ini adalah alat prototipe, bukan validator kontrak.

MockServer

MockServer adalah alat berat untuk pencocokan permintaan yang tepat. Di mana alat-alat di atas melayani spesifikasi atau file data, MockServer memungkinkan Anda mendefinisikan ekspektasi: cocokkan permintaan berdasarkan metode, path, header, kueri, atau body, lalu kembalikan respons yang Anda inginkan, termasuk penundaan dan kegagalan untuk menguji timeout dan penanganan kesalahan.

java -jar mockserver-netty-5.15.0-no-dependencies.jar -p 1080

Itu memulai MockServer di port 1080. Anda kemudian mengirim ekspektasi ke REST API-nya untuk mengkonfigurasi perilaku, atau menggerakkannya secara terprogram. Pengguna Node dapat melewati jar mentah dan menggunakan wrapper resmi:

npm install mockserver-node

const mockserver = require('mockserver-node');
mockserver.start_mockserver({ serverPort: 1080 });

Terbaik untuk: pengujian integrasi yang membutuhkan kontrol halus atas seperti apa seharusnya permintaan dan bagaimana mock merespons. Ini dilisensikan Apache-2.0 dan mendukung HTTP, HTTPS, dan lainnya pada satu port.

Batasan jujur: ini adalah server JVM, jadi lebih berat dan lebih lambat untuk memulai daripada alat Node, dan pengaturan ekspektasi lebih verbose daripada menunjuk ke spesifikasi. Jika Anda hanya membutuhkan spesifikasi yang dilayani, itu berlebihan; jika Anda tumbuh melebihi itu, perbandingan alternatif MockServer menjelaskan trade-off-nya.

WireMock (mandiri)

WireMock adalah server mock JVM lain yang sudah mapan, populer di dunia pengujian Java dan JVM. Jar mandirinya menjalankan mesin yang sama dengan yang akan Anda sematkan dalam pengujian JUnit, sehingga mock yang Anda buat dalam pengembangan lokal langsung masuk ke suite pengujian Anda.

java -jar wiremock-standalone.jar --port 8080

Itu melayani di port 8080. WireMock membaca pemetaan stub dari direktori mappings/ atau JSON API-nya, dan juga dapat merekam lalu lintas nyata dan memutarnya kembali sebagai stub, yang berguna saat Anda melakukan mocking API pihak ketiga yang tidak Anda kendalikan. Ada citra Docker resmi wiremock/wiremock untuk CI.

Terbaik untuk: tim JVM yang menginginkan satu mesin mocking yang dibagi antara pengembangan lokal dan suite pengujian mereka, ditambah record-and-replay. Ini dilisensikan Apache-2.0.

Batasan jujur: seperti MockServer, ia membutuhkan runtime Java dan memulai lebih lambat daripada opsi Node. JSON pemetaan stub-nya kuat tetapi lebih banyak untuk dipelajari daripada mock data satu file. Jika Anda berasal dari sisi JavaScript, perbandingan alternatif Mock Service Worker (MSW) membahas di mana WireMock cocok dengan mocking yang mengutamakan browser.

Apidog CLI

Setiap alat di atas memecahkan satu bagian dari mocking. Apidog mengambil rute terintegrasi: desain API Anda, mock, pengujian Anda, dan dokumen Anda hidup dalam satu proyek, dan Apidog CLI menggerakkan proyek itu dari terminal. Apidog bukan open source; ini adalah produk komersial dengan tingkatan gratis. Tetapi tingkatan gratis itu ditambah CLI memberi Anda alternatif untuk menyatukan server mock, test runner, dan alat spesifikasi yang terpisah.

Apidog secara otomatis menghasilkan mock cerdas dari setiap endpoint yang Anda definisikan, dengan respons yang mengikuti tipe bidang dan penamaan skema Anda, sehingga bidang phone mengembalikan nomor telepon yang masuk akal daripada string acak. Ketika Anda membutuhkan respons spesifik untuk permintaan spesifik, Anda menambahkan ekspektasi mock. CLI mengelola sumber daya mock tersebut sebagai bagian dari proyek:

npm install -g apidog-cli
apidog login --with-token <YOUR_TOKEN>
apidog mock --help

Grup perintah mock bekerja dengan ekspektasi mock proyek Anda dari skrip dan CI, bersama dengan grup perintah untuk endpoint, skema, lingkungan, dan uji coba. Output adalah JSON terstruktur dengan bidang agentHints.nextSteps, yang membuatnya dapat digunakan oleh agen AI maupun manusia. Permukaan perintah lengkap dibahas dalam panduan lengkap Apidog CLI.

Terbaik untuk: tim yang lebih suka menyimpan mock, spesifikasi, dan pengujian di satu tempat daripada menjalankan tiga alat terpisah. Unduh Apidog untuk mencoba server mock bawaan dan CLI di proyek Anda sendiri.

Batasan jujur: ini adalah platform, bukan biner tujuan tunggal, jadi ia meminta proyek dan login di mana json-server tidak meminta apa pun. Jika yang Anda butuhkan hanyalah mock sekali pakai dari satu file, alat yang lebih ringan menang; jika Anda sudah mendesain API Anda di Apidog, mock sudah ada di sana.

Cara memilih

Cocokkan alat dengan apa yang sudah Anda miliki. Jika Anda memiliki spesifikasi OpenAPI, Prism atau Mockoon CLI langsung melayaninya. Jika Anda belum memiliki apa-apa, json-server menciptakan API dari file JSON. Jika Anda membutuhkan pencocokan permintaan yang tepat, gunakan MockServer atau WireMock. Jika Anda ingin mock hidup di samping desain dan pengujian Anda, gunakan Apidog.

Aturan kasarnya: alat npx untuk kecepatan, server JVM untuk kedalaman pencocokan, Apidog saat Anda menginginkan satu alur kerja daripada beberapa. Jika Anda masih memutuskan apakah akan melakukan mocking sama sekali, panduan kasus penggunaan mocking API membahas kapan itu menguntungkan.

Kesimpulan

Mocking ringan bermuara pada satu pertanyaan: apa yang sudah Anda miliki untuk diumpankan ke alat? Spesifikasi masuk ke Prism atau Mockoon CLI. Lingkungan kosong masuk ke json-server. Pencocokan ketat masuk ke MockServer atau WireMock. Dan jika Anda lebih suka tidak menjalankan dan menghubungkan beberapa alat, Apidog menyimpan mock di samping desain dan pengujian, digerakkan dari CLI yang sama yang akan Anda skrip.

Keenamnya berjalan dari terminal, cocok dalam pekerjaan CI, dan memberi Anda API palsu dalam hitungan detik alih-alih berjam-jam. Pilih yang terkecil yang sesuai dengan kasus Anda, dan tambahkan bobot hanya saat Anda benar-benar membutuhkannya. Untuk melihat versi terintegrasi, Unduh Apidog dan hasilkan server mock dari desain API Anda dalam satu langkah.