Alat mock API tanpa kepala (headless) membuat tiruan API yang berfungsi dari spesifikasi atau konfigurasi, lalu menjalankannya dari baris perintah tanpa perlu jendela untuk diklik. Itulah yang Anda butuhkan di dalam pipeline CI, kontainer Docker, atau skrip pengembangan frontend. Panduan ini menjelaskan arti "headless" untuk mocking, menunjukkan opsi headless yang sebenarnya (Prism, WireMock, Mockoon CLI), dan membahas di mana Apidog cocok. Jika Anda ingin memahami konsepnya terlebih dahulu, mulailah dengan apa itu mock API.
Apa arti "headless" untuk mock API
Server mock menjawab permintaan HTTP dengan respons palsu namun realistis, sehingga frontend atau rangkaian uji dapat berjalan sebelum backend yang sebenarnya ada. "Headless" berarti mock berjalan tanpa antarmuka grafis. Anda memulainya dengan perintah, mengarahkannya ke spesifikasi atau file data, dan itu mendengarkan pada port.
Ini penting karena tempat-tempat yang paling Anda inginkan mock adalah tempat-tempat tanpa layar:
- Pekerjaan CI yang membutuhkan backend yang stabil untuk diuji.
- Kontainer Docker dalam tumpukan
docker-compose. - Terminal rekan tim yang ingin mock berjalan di latar belakang.
- Lingkungan pratinjau sementara yang dibuat per permintaan tarik (pull request).
Alat mock GUI baik untuk mendesain respons di laptop Anda. Tetapi saat Anda membutuhkan mock itu dalam pipeline, Anda membutuhkan mode headless: flag CLI, citra Docker, atau URL yang di-hosting yang dapat diakses oleh pekerjaan apa pun.
Mock Berbasis Spesifikasi vs Mock Berbasis Konfigurasi
Alat mock headless terbagi menjadi dua kelompok, dan perbedaannya membentuk seluruh alur kerja Anda.
Alat berbasis spesifikasi membaca dokumen OpenAPI Anda dan menyajikan respons langsung darinya. Skema adalah sumber kebenaran. Tambahkan bidang ke spesifikasi, dan mock akan mengembalikannya. Ini menjaga mock tetap jujur karena tidak dapat menyimpang jauh dari kontrak.
Alat berbasis konfigurasi menyimpan respons dalam formatnya sendiri (file JSON, stub yang direkam, aturan yang ditulis tangan). Mereka fleksibel dan bagus untuk kasus-kasus khusus yang tidak tercakup dalam spesifikasi, tetapi Anda mengelola konfigurasi itu secara manual, dan dapat menyimpang dari API yang sebenarnya.
Sebagian besar tim menginginkan berbasis spesifikasi untuk jalur yang biasa dan override berbasis konfigurasi untuk kasus-kasus aneh. Pengaturan mocking API terbaik mendukung keduanya.
Pilihan mock headless, secara jujur
Berikut adalah alat-alat yang patut Anda ketahui. Masing-masing berjalan tanpa GUI, dan masing-masing memiliki kekuatan nyata.
Prism (Stoplight)
Prism mengubah file OpenAPI 2/3 atau Postman Collection menjadi server mock dari satu perintah:
prism mock openapi.yaml
Secara default, ini mendengarkan pada http://127.0.0.1:4010. Secara default, ini mengembalikan examples statis dari spesifikasi Anda. Tambahkan -d (dinamis) dan Prism menghasilkan data acak namun valid dari skema, dengan dukungan Faker melalui ekstensi x-faker. Ini open source, ringan, dan benar-benar spec-first. Jika kontrak Anda berada dalam satu file OpenAPI dan Anda ingin mock CLI murni, Prism adalah pilihan yang kuat.
WireMock
WireMock adalah server mock HTTP berbasis Java yang matang. Anda menjalankan jar mandiri:
java -jar wiremock-standalone-3.x.x.jar --port 9099
Model intinya adalah stubbing: Anda mendefinisikan aturan pencocokan permintaan dan respons yang dikembalikannya, melalui API JSON atau file JSON. Ini juga merekam dan memutar ulang lalu lintas dari layanan nyata, yang berguna ketika Anda tidak memiliki spesifikasi tetapi Anda memiliki backend yang berfungsi untuk ditangkap. WireMock bersinar untuk pencocokan permintaan yang kompleks, skenario berstatus, dan tumpukan yang berat JVM.
Mockoon CLI
Mockoon adalah aplikasi desktop dengan CLI pendamping untuk penggunaan headless. CLI menjalankan lingkungan mock yang Anda bangun, di server, di CI, atau di mana pun Anda tidak dapat membuka aplikasi desktop:
mockoon-cli start --data ./environment.json --port 3000
Ia mengirimkan citra Docker resmi dan perintah dockerize yang menghasilkan Dockerfile untuk citra mock mandiri. Mockoon berbasis konfigurasi (Anda membangun lingkungan di GUI, lalu menjalankannya secara headless), dengan templating, aturan respons, dan mode proxy. Cocok jika Anda suka mendesain secara visual dan menerapkan secara headless.
Server mock Apidog
Apidog adalah platform API all-in-one, dan server mock-nya secara default berbasis skema. Saat Anda mendefinisikan atau mengimpor API, Apidog menghasilkan mock tanpa pengaturan tambahan. Smart Mock-nya membaca nama dan tipe bidang untuk menghasilkan data realistis: ia mengenali hal-hal seperti email, avatar, username, phone, date, dan IP, dan mengisinya dengan nilai yang masuk akal alih-alih placeholder string. Untuk kontrol penuh, Anda dapat menggunakan ekspresi Faker.js seperti {{$person.fullName}} atau {{$number.int(min=1,max=100)}}, ditambah aturan mock kustom untuk kondisi permintaan tertentu.
Untuk penggunaan headless, Apidog mengekspos URL Cloud Mock (https://mock.apidog.com/...) yang dapat diakses oleh pekerjaan CI atau rekan tim mana pun tanpa perlu menjalankan apa pun secara lokal. Mock lokal juga berjalan pada 127.0.0.1, dan Anda dapat mengikatnya ke IP intranet Anda agar mesin lain dapat mencapainya. Karena mock berasal dari proyek yang sama yang menyimpan desain API, dokumen, dan pengujian Anda, ia tetap selaras dengan kontrak alih-alih menyimpang ke file konfigurasi terpisah.
Perbandingan
| Alat | Sumber kebenaran | Jalankan Headless | Data realistis | Terbaik untuk |
|---|---|---|---|---|
| Prism | File OpenAPI / Postman | prism mock spec.yaml |
Mode dinamis (-d) + x-faker |
Mocking CLI berbasis spesifikasi murni |
| WireMock | Aturan stub / rekaman | Jar mandiri | Templating respons | Pencocokan kompleks, tumpukan JVM, rekam/putar ulang |
| Mockoon CLI | Lingkungan yang dibangun GUI | mockoon-cli start + Docker |
Helper templating | Desain visual, deploy headless |
| Apidog | Skema API dalam proyek | URL Cloud Mock + server lokal | Smart Mock + Faker.js | Mock berbasis skema yang terkait dengan desain, dokumen, dan pengujian |
Tidak ada pemenang tunggal. Prism adalah yang paling bersih jika seluruh API Anda adalah satu file OpenAPI. WireMock unggul dalam kedalaman pencocokan permintaan. Mockoon hebat jika Anda lebih suka membangun secara visual. Apidog cocok untuk tim yang menginginkan mock, kontrak, dokumen, dan pengujian di satu tempat agar tidak terpisah. Untuk bidang yang lebih luas, lihat rangkuman kami tentang alat mock API terbaik.
Menjalankan mock headless di CI
Polanya sama di semua alat. Anda memulai mock, mengarahkan pengujian Anda ke sana, dan menghentikannya.
Mock CLI berbasis spesifikasi pertama terlihat seperti ini dalam langkah pipeline:
# mulai mock di latar belakang
prism mock ./openapi.yaml &
MOCK_PID=$!
# jalankan pengujian frontend atau API Anda terhadap http://127.0.0.1:4010
npm test
# bersihkan
kill $MOCK_PID
Dengan Apidog, Anda dapat melewati menjalankan apa pun dengan mengarahkan pengujian ke URL Cloud Mock, atau menjalankan mock lokal dengan cara yang sama. Mock menjawab dari skema Anda saat ini, jadi ketika kontrak berubah, mock juga ikut berubah.
Langkah selanjutnya yang alami adalah menguji mock tersebut dari baris perintah. CLI Apidog (apidog-cli) itu sendiri tanpa kepala (headless): apidog run menjalankan skenario pengujian Anda di CI, mendukung eksekusi berbasis data dari CSV atau JSON, dan menulis laporan CLI, HTML, atau JSON. Panduan dalam menguji REST API dari baris perintah menunjukkan alur lengkapnya, dan panduan CLI lengkap mencakup flag-nya. Jika Anda pernah menggunakan Newman, perbandingan Apidog CLI vs Postman CLI memetakan konsep-konsep tersebut.
Mock dan agen pengkodean AI
Jika Anda menulis kode dengan Cursor, Claude, atau VS Code, agen Anda mendapat manfaat dari mengetahui kontrak API di balik mock. Server MCP Apidog memungkinkan agen AI membaca spesifikasi API Anda secara langsung, sehingga dapat membuat kode klien yang cocok dengan skema yang sudah dilayani oleh mock Anda. Ini menjaga output agen dan respons mock Anda tetap mengarah pada kontrak yang sama.
Pertanyaan yang sering diajukan
Apakah mock headless sama dengan server mock?
Ya, dengan satu detail. Server mock adalah proses apa pun yang menjawab permintaan dengan respons palsu. "Headless" menentukan bahwa ia berjalan tanpa GUI, dimulai oleh perintah atau di-hosting di URL, sehingga berfungsi di CI, Docker, dan skrip. Setiap alat di sini dapat berjalan secara headless.
Dapatkah saya membuat mock headless dari spesifikasi OpenAPI saya?
Ya. Prism membaca OpenAPI secara langsung, dan Apidog menghasilkan mock dari skema di proyek Anda. Mock berbasis spesifikasi menghemat upaya dan tetap lebih dekat ke kontrak, karena mock mencerminkan apa yang dikatakan spesifikasi daripada konfigurasi yang dikelola secara terpisah. Lihat panduan mocking API kami untuk alur kerja lengkapnya.
Bagaimana mock headless mengembalikan data realistis alih-alih placeholder?
Setiap alat memiliki mesin datanya. Mode dinamis Prism dan x-faker menghasilkan nilai dari skema. Smart Mock Apidog mencocokkan nama bidang seperti email atau phone dengan nilai yang masuk akal, dan Anda dapat menyisipkan ekspresi Faker.js untuk kontrol yang lebih halus. Tanpa salah satu dari ini, mock cenderung mengembalikan string kosong dan nol.
Apakah saya perlu menjalankan server, atau bisakah saya menggunakan URL mock yang di-hosting?
Keduanya berfungsi. WireMock, Prism, dan Mockoon CLI menjalankan proses yang Anda kelola. Apidog menambahkan URL Cloud Mock yang di-hosting yang dapat dipanggil oleh pekerjaan CI atau rekan tim mana pun tanpa pengaturan lokal, yang menghilangkan satu bagian yang bergerak dari pipeline.
Kesimpulan
Alat mock API tanpa kepala (headless) adalah perbedaan antara mock yang membantu Anda mengklik secara lokal dan yang benar-benar berjalan di pipeline Anda. Prism, WireMock, dan Mockoon CLI masing-masing melakukan ini dengan baik untuk gaya kerja mereka. Jika Anda ingin mock tetap terikat pada desain, dokumen, dan pengujian API Anda alih-alih berada dalam konfigurasinya sendiri yang menyimpang, Apidog menyimpan semuanya dalam satu proyek, dengan mock berbasis skema yang berjalan secara lokal atau dari URL yang di-hosting. Unduh Apidog untuk membuat mock dari spesifikasi Anda dan arahkan CI Anda ke sana.