Tim frontend Anda terhambat. Desain telah disetujui, layar sudah setengah jadi, dan satu-satunya yang menghalangi adalah API yang belum ada. Backend masih butuh waktu, sehingga UI tidak memiliki sesuatu yang nyata untuk dipanggil. Solusi sementara yang biasa adalah mock lokal, dan itu berfungsi sampai saat Anda menutup laptop Anda. Kemudian endpoint yang diakses rekan tim Anda di zona waktu lain menjadi tidak aktif.
Itulah celah yang ditutup Apidog dengan Cloud Mock. Alih-alih mock yang hidup dan mati di satu mesin, Anda mendapatkan URL publik yang di-hosting di mock.apidog.com yang tetap aktif sepanjang waktu. Pengembang frontend, QA, dan mitra semuanya dapat mengakses endpoint yang realistis sebelum satu baris kode backend pun dikirim. Jika Anda ingin gambaran lebih luas tentang manfaat mocking bagi tim, panduan kami tentang apa itu mock API dan kapan menggunakannya akan menjadi permulaan. Untuk mekanisme bagaimana URL mock publik sesuai dengan penanganan permintaan, referensi MDN tentang model permintaan/respons HTTP adalah penyegaran yang bagus.
Apa itu Cloud Mock dan mengapa mock lokal kurang efektif
Apidog menghasilkan endpoint mock untuk setiap API yang Anda desain. Secara default, mock tersebut adalah mock lokal: ia berjalan dari instance Apidog Anda dan merespons saat mesin Anda aktif. Saat Anda mematikan mesin, endpoint berhenti merespons. Itu baik untuk debugging sendiri. Itu akan rusak saat orang lain bergantung pada URL tersebut.
Cloud Mock adalah solusinya. Ini adalah endpoint mock yang tersedia secara terus-menerus yang bertahan secara independen dari mesin individu mana pun. Komputer rekan tim Anda bisa dalam keadaan tidur, laptop Anda bisa di dalam tas, dan cloud mock terus menjawab permintaan 24/7. Endpoint ini berada di layanan hosting Apidog, jadi ketersediaan tidak terikat pada siapa yang online.
Manfaat praktisnya adalah serah terima yang bersih. Anda merancang kontraknya, mengaktifkan Cloud Mock, dan membagikan satu URL. Frontend membangun berdasarkan data realistis, QA menulis kasus uji berdasarkan bentuk respons nyata, dan mitra yang berintegrasi dengan Anda dapat segera mulai menghubungkan klien mereka. Tidak ada yang menunggu backend, dan tidak ada yang menunggu Anda untuk menjaga proses tetap berjalan. Jika Anda mengoordinasikan ini antar wilayah, pola dalam berbagi server mock dan lingkungan dengan tim global akan membahas alur kerja secara lebih mendalam.
Aktifkan Cloud Mock dan dapatkan URL publik Anda
Mari kita bahas dengan API yang realistis. Misalkan Anda sedang membangun layanan users dengan endpoint GET /users yang mengembalikan daftar catatan pelanggan. Berikut adalah cara Anda mengubahnya menjadi endpoint cloud yang dapat dibagikan.
Langkah 1: aktifkan Cloud Mock
Buka proyek Anda dan buka Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock. Aktifkan Cloud Mock. Itu adalah sakelar yang memberi tahu Apidog untuk meng-hosting mock Anda di layanan yang selalu aktif alih-alih hanya melayani secara lokal.
Anda hanya melakukan ini sekali per proyek. Setelah diaktifkan, setiap endpoint dalam proyek akan mendapatkan URL cloud mock di samping URL lokalnya.
Langkah 2: salin URL cloud mock
Buka endpoint yang ingin Anda bagikan, GET /users dalam kasus ini. Buka tab Mock-nya dan salin URL Cloud Mock. Anda akan mendapatkan sesuatu yang berbentuk seperti ini:
https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi
Struktur path mengikuti pola: mock.apidog.com/m1/<projectId>-<num>-<env>/<path>. Apidog membangunnya untuk Anda, jadi Anda tidak perlu menyusunnya secara manual. Perhatikan bahwa dokumen ini menunjukkannya sebagai contoh daripada memublikasikan templat tetap, jadi perlakukan URL yang disalin sebagai sumber kebenaran daripada mencoba membuat sendiri.
Langkah 3: uji mock secara instan di dalam Apidog
Sebelum Anda menyerahkan URL tersebut kepada siapa pun, pastikan URL tersebut mengembalikan apa yang Anda harapkan. Pada tab Mock yang sama, kirim permintaan uji terhadap URL mock tersebut. Apidog mengirimkan permintaan dan menunjukkan responsnya di sana. Anda mendapatkan pembacaan instan apakah data yang dihasilkan terlihat benar.
Mock GET /users mungkin akan kembali seperti ini:
[
{
"id": 1,
"name": "Amelia Turner",
"email": "amelia.turner@example.com",
"city": "Portland"
},
{
"id": 2,
"name": "Marcus Bell",
"email": "marcus.bell@example.com",
"city": "Austin"
}
]
Nilai-nilai tersebut tidak di-hardcode. Apidog membaca nama dan tipe bidang skema Anda dan menghasilkan data yang masuk akal untuk dicocokkan, itulah yang membuat mock berguna bagi frontend yang merender tabel yang terlihat nyata.
Langkah 4: buka URL di browser
Untuk permintaan GET, URL cloud mock berfungsi langsung di browser web. Tempelkan ke bilah alamat dan Anda akan melihat respons JSON. Ini adalah pemeriksaan kewarasan tercepat yang dapat Anda berikan kepada pemangku kepentingan non-teknis: tidak ada klien, tidak ada curl, hanya tautan yang mengembalikan data.
Untuk apa pun selain melihat sekilas, frontend Anda memanggilnya seperti endpoint lainnya:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Itulah seluruh alurnya. Rancang endpoint-nya, aktifkan Cloud Mock, salin URL-nya, dan tim Anda tidak lagi terhambat.
Amankan mock dengan autentikasi token
URL publik itu nyaman, dan kadang terlalu nyaman. Jika mock Anda mencerminkan fitur yang belum dirilis atau integrasi mitra yang tidak ingin Anda ekspos, Anda dapat membatasinya.
Buka Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock dan atur izin akses ke Autentikasi Token. Setelah diaktifkan, setiap permintaan harus membawa apidogToken yang valid, dan permintaan tanpa token akan ditolak. Anda dapat menyediakan token dengan tiga cara:
Sebagai parameter string-kueri URL, yang sudah digunakan oleh URL yang disalin:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Sebagai header permintaan, yang menjaga token keluar dari URL dan dari log server:
curl "https://mock.apidog.com/m1/2689726-0-default/users" \
-H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Atau sebagai parameter body bernama apidogToken dalam permintaan form-data atau x-www-form-urlencoded, yang cocok untuk klien yang mengirimkan body formulir.
Untuk kode frontend, pendekatan header biasanya yang paling bersih. Ini menjaga token keluar dari apa pun yang mencatat URL lengkap, dan memisahkan kredensial dari jalur sumber daya:
const res = await fetch(
"https://mock.apidog.com/m1/2689726-0-default/users",
{ headers: { apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi" } }
);
const users = await res.json();
Satu hal yang perlu direncanakan: jika Anda mengaktifkan Autentikasi Token setelah membagikan URL biasa, setiap konsumen perlu menambahkan token atau panggilan mereka akan mulai gagal. Koordinasikan perubahan tersebut agar QA dan mitra tidak dibiarkan menatap permintaan yang ditolak.
Hasilkan data realistis yang peka wilayah dengan lokal
Mock yang mengembalikan "name": "string" untuk setiap catatan tidak mengajarkan apa pun kepada UI Anda. Mock yang mengembalikan nama, alamat, dan nomor telepon yang terlihat nyata memungkinkan frontend menangkap bug tata letak, kelebihan teks, dan masalah pemformatan sebelum data nyata tiba. Apidog menangani ini dengan Faker.js di balik layar, dan kontrol lokal di sinilah ia benar-benar berguna untuk produk internasional.
Bagaimana lokal default bekerja
Secara default, Faker mengikuti pengaturan bahasa proyek Anda. Itu dikonfigurasi di Pengaturan Proyek > Pengaturan Dasar, dan bahasa apa pun yang Anda pilih di sana menjadi lokal default untuk semua nilai mock yang dihasilkan. Atur proyek ke bahasa Prancis dan nama serta alamat mock Anda akan kembali dengan nuansa Prancis tanpa pekerjaan per bidang apa pun.
Timpa lokal untuk seluruh proyek
Jika Anda menginginkan data mock dalam lokal tertentu yang berbeda dari bahasa proyek, Anda dapat menimpanya. Buka Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock dan pilih lokal Faker dari dropdown. Penimpaan itu akan mengalahkan default bahasa Pengaturan Dasar untuk setiap bidang dalam proyek.
Ini berguna saat Anda menguji internasionalisasi. Arahkan lokal proyek ke Jepang dan setiap alamat, nama, dan nomor telepon yang dihasilkan mencerminkan wilayah tersebut, sehingga Anda dapat melihat bagaimana UI Anda bertahan terhadap skrip non-Latin dan format alamat yang berbeda. Pembuatan data yang peka skema semacam ini secara otomatis adalah topik tersendiri, dan panduan tentang mock pintar Apidog dan cara membaca skemanya membahas sisi pembuatan secara rinci.
Timpa lokal per bidang
Terkadang Anda membutuhkan satu bidang dalam lokal yang berbeda dari yang lain, misalnya daftar pelanggan yang mencampur wilayah. Anda dapat mengatur lokal langsung di ekspresi mock menggunakan parameter locale:
{{$person.fullName(locale='ja')}}
Itu menghasilkan nama Jepang seperti 田中 太郎 hanya untuk bidang itu, sementara sisa respons mengikuti lokal proyek. Urutan prioritas berjalan dalam tiga tingkatan: lokal tingkat bidang menimpa lokal tingkat proyek, yang menimpa default bahasa Pengaturan Dasar. Jadi Anda menetapkan default proyek yang masuk akal dan hanya menggunakan penimpaan tingkat bidang di mana Anda benar-benar membutuhkan pengecualian.
Catatan singkat tentang ruang lingkup: dokumen menunjukkan ja sebagai contoh yang dikerjakan dan tidak memublikasikan daftar lengkap lokal yang didukung, jadi konfirmasikan kode yang tepat untuk wilayah target Anda di dokumentasi mock Apidog sebelum Anda menggunakannya. Konvensi Faker sendiri didokumentasikan di referensi lokal Faker.js.
Cocokkan zona waktu juga
Ada kontrol paralel untuk waktu. Default tingkat proyek berada di Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock, dan Anda dapat menimpa per bidang dengan parameter timeZone di dalam ekspresi mock. Jika UI Anda merender stempel waktu, ini menjaga nilai createdAt yang dihasilkan konsisten dengan wilayah yang Anda simulasikan daripada default ke lokasi server Anda.
Antara kontrol lokal dan zona waktu, Anda dapat menyiapkan mock yang secara meyakinkan meniru basis pengguna Jepang, Jerman, atau kelompok internasional campuran, semuanya dari skema endpoint yang sama. Untuk serangkaian skenario yang lebih luas yang dibuka ini, ringkasan kasus penggunaan API mocking praktis patut untuk dilihat.
Cloud Mock versus mock yang di-hosting sendiri
Cloud Mock adalah opsi hosting Apidog, dan ini mencakup sebagian besar tim. Jika organisasi Anda memiliki aturan residensi data atau kebijakan yang menentang perutean lalu lintas uji melalui cloud vendor, Apidog juga mendukung menjalankan layanan mock di infrastruktur Anda sendiri. Pertukaran ini lugas: opsi cloud tidak memerlukan penyiapan dan selalu aktif, sementara hosting sendiri memberi Anda kendali dengan biaya menjalankan layanan itu sendiri. Jika itu situasi Anda, panduan hosting sendiri server mock Apidog membahasnya. Untuk tim yang membandingkan opsi hosting berdampingan, perbandingan alat API mocking online menjelaskan lanskapnya.
Mengenai batasan paket, satu jawaban lugas: fitur Cloud Mock dan lokal yang didokumentasikan di sini tidak menyatakan persyaratan paket tertentu, jadi langkah jujur adalah memeriksa ketersediaan saat ini di akun Anda sendiri daripada mengambil angka dari postingan blog. Anda dapat Mengunduh Apidog dan mencoba alur dari awal hingga akhir untuk melihat dengan tepat apa saja yang termasuk dalam ruang kerja Anda.
Otomatiskan alur kerja dengan Apidog CLI
Mocking di Apidog adalah kemampuan GUI dan cloud. Respons mock dihasilkan secara otomatis dari skema endpoint Anda, dan dilayani oleh mesin hosting Apidog, bukan oleh apa pun yang Anda jalankan di terminal. Jadi kerangka jujurnya adalah ini: Apidog CLI tidak memulai atau melayani server mock. Yang dilakukannya adalah menjaga input ke mock Anda tetap akurat.
CLI dan agen coding AI seperti Cursor atau Claude Code dapat membuat dan memperbarui endpoint dan skema dalam proyek Anda. Karena cloud mock membaca skema tersebut untuk menghasilkan data, menjaga spesifikasi tetap terkini akan menjaga output mock tetap jujur seiring dengan evolusi API. Ketika Anda menggunakan alat agen untuk menambahkan bidang, mock akan mencerminkannya tanpa pengeditan manual.
Kemudian, setelah mock berhasil membuka blokir pekerjaan frontend dan backend yang sebenarnya telah diterapkan, skenario uji proyek yang sama akan berjalan tanpa kepala melawannya. Perintah eksekusi CLI memvalidasi backend langsung terhadap kontrak yang sama yang dijelaskan oleh mock:
apidog run -t <scenario_id> -e <env_id> -r cli
Perintah tunggal itu menjalankan skenario uji yang disimpan terhadap suatu lingkungan dan melaporkan hasilnya, sehingga mock yang membuka blokir UI dan pengujian yang memverifikasi backend keduanya menunjuk pada satu sumber kebenaran. Buka skenario Anda di Apidog dan salin perintah yang dihasilkan dengan ID skenario -t dan ID lingkungan -e yang sudah terisi, daripada menyusun flag secara manual. Menghubungkan itu ke dalam pipeline dibahas dalam panduan menjalankan Apidog dalam pipeline CI/CD.
FAQ
Apakah URL cloud mock tetap berfungsi saat saya menutup Apidog?
Ya, itulah inti dari Cloud Mock. Tidak seperti mock lokal, yang berhenti merespons saat mesin hosting dimatikan, cloud mock disajikan dari infrastruktur Apidog dan tetap tersedia 24/7. Rekan tim Anda dapat mengaksesnya terlepas dari apakah komputer Anda aktif.
Bisakah saya menggunakan URL cloud mock langsung di browser?
Untuk permintaan GET, ya. Tempelkan URL lengkap, termasuk parameter query apidogToken, ke bilah alamat Anda dan Anda akan melihat respons JSON. Untuk metode lain atau untuk menjaga token keluar dari riwayat URL Anda, panggil dengan alat seperti curl atau klien frontend Anda dan teruskan token sebagai header saja.
Apa yang terjadi pada permintaan yang tidak menyertakan token?
Jika Anda telah mengatur izin akses ke Autentikasi Token, setiap permintaan tanpa apidogToken yang valid akan ditolak. Berikan sebagai parameter string-kueri, header permintaan, atau parameter body dalam permintaan formulir. Jika Anda mengaktifkan autentikasi token setelah membagikan URL biasa, beritahu konsumen Anda agar mereka dapat menambahkan token sebelum panggilan mereka mulai gagal.
Bagaimana cara mendapatkan data mock yang sesuai dengan negara tertentu?
Atur lokal proyek Anda di Pengaturan Dasar, atau timpa untuk seluruh proyek di bawah Pengaturan Fitur > Pengaturan Mock, atau timpa satu bidang dengan parameter locale dalam ekspresi mock, seperti {{$person.fullName(locale='ja')}}. Tingkat bidang mengalahkan tingkat proyek, yang mengalahkan default Pengaturan Dasar. Panduan mock pintar menunjukkan bagaimana pembuatan yang peka skema terkait dengan ini.
Haruskah saya menggunakan Cloud Mock atau alat mock headless?
Cloud Mock cocok untuk tim yang menginginkan endpoint hosting tanpa pemeliharaan yang terikat pada desain API mereka. Jika Anda membutuhkan mock yang disematkan dalam build otomatis tanpa GUI sama sekali, survei alat mock headless membandingkan opsi-opsi dan di mana masing-masing cocok. Spesifikasi OpenAPI Initiative menjadi dasar sebagian besar alat ini, jadi spesifikasi yang bersih akan membuahkan hasil apa pun jalur yang Anda pilih.
Kesimpulan
Mock yang hanya ada di laptop Anda hanya membuka blokir satu orang. Cloud Mock mengubahnya menjadi URL publik mock.apidog.com yang dapat digunakan seluruh tim Anda, dengan autentikasi token saat Anda perlu membatasinya dan kontrol lokal saat data Anda perlu terlihat nyata untuk wilayah tertentu. Desain endpoint-nya, alihkan sakelar, bagikan tautannya, dan frontend berhenti menunggu backend. Unduh Apidog untuk menyiapkan cloud mock pertama Anda yang dapat dibagikan, gratis dan tanpa kartu kredit.