Cara Membuat Mock Server Cloud yang Dapat Dibagikan dengan Apidog

Tim frontend sering terhenti pada titik yang sama: desain sudah disetujui, UI mulai dibangun, tetapi API backend belum siap. Mock lokal memang bisa membantu, tetapi hanya berjalan selama mesin Anda aktif. Saat laptop ditutup, endpoint ikut berhenti—dan rekan tim di zona waktu lain kehilangan akses.

Coba Apidog hari ini

Apidog menutup celah ini melalui Cloud Mock. Anda dapat membuat URL publik di mock.apidog.com yang tetap tersedia tanpa bergantung pada laptop pengembang. Frontend, QA, dan mitra integrasi dapat menggunakan endpoint realistis bahkan sebelum backend di-deploy. Untuk konteks lebih luas, lihat panduan apa itu mock API dan kapan menggunakannya. Untuk menyegarkan konsep request/response, baca referensi model HTTP dari MDN.

Apa itu Cloud Mock dan mengapa mock lokal kurang efektif

Apidog dapat menghasilkan endpoint mock dari API yang Anda desain. Secara default, mock lokal berjalan dari instance Apidog di mesin Anda. Pendekatan ini cocok untuk debugging pribadi, tetapi endpoint tidak lagi tersedia ketika mesin dimatikan.

Cloud Mock menyediakan endpoint mock yang di-hosting dan tersedia secara berkelanjutan. URL tersebut tetap merespons meskipun laptop Anda offline, sehingga tim dapat menggunakan kontrak API yang sama tanpa menunggu backend selesai.

Alur kerja praktisnya:

1. Desain kontrak API dan schema respons.
2. Aktifkan Cloud Mock pada proyek.
3. Salin URL mock publik.
4. Bagikan URL kepada frontend, QA, atau mitra.
5. Perbarui schema saat kontrak API berubah.

Dengan alur ini, frontend dapat membangun UI dari data realistis, QA dapat menulis test case berdasarkan respons yang stabil, dan mitra dapat mulai menghubungkan klien mereka lebih awal. Untuk kolaborasi lintas wilayah, lihat panduan berbagi server mock dan lingkungan dengan tim global.

Aktifkan Cloud Mock dan dapatkan URL publik

Contoh berikut menggunakan layanan users dengan endpoint GET /users.

Langkah 1: aktifkan Cloud Mock

Di proyek Apidog, buka:

Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock

Aktifkan Cloud Mock.

Pengaturan ini cukup dilakukan sekali per proyek. Setelah aktif, endpoint proyek akan memiliki URL Cloud Mock selain URL mock lokal.

Langkah 2: salin URL Cloud Mock

Buka endpoint GET /users, lalu buka tab Mock. Salin URL Cloud Mock yang tersedia.

Contoh URL:

https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi

Format path umumnya mengikuti pola berikut:

mock.apidog.com/m1/<projectId>-<num>-<env>/<path>

Jangan menyusun URL secara manual. Selalu gunakan URL yang disalin dari Apidog karena URL tersebut adalah sumber kebenaran untuk proyek dan environment Anda.

Langkah 3: uji respons mock di Apidog

Sebelum membagikan URL, uji endpoint dari tab Mock:

1. Pilih endpoint.
2. Kirim request ke URL mock.
3. Periksa status, header, dan body respons.
4. Pastikan struktur respons sesuai dengan kebutuhan consumer API.

Contoh respons GET /users:

[
  {
    "id": 1,
    "name": "Amelia Turner",
    "email": "[e-mail]",
    "city": "Portland"
  },
  {
    "id": 2,
    "name": "Marcus Bell",
    "email": "[e-mail]",
    "city": "Austin"
  }
]

Nilai mock dibuat berdasarkan nama dan tipe field pada schema. Karena itu, frontend dapat langsung menguji tabel, kartu profil, pencarian, state kosong, atau validasi format tanpa menunggu database backend tersedia.

Langkah 4: panggil URL dari browser atau aplikasi

Untuk request GET, buka URL Cloud Mock langsung di browser untuk pemeriksaan cepat. Browser akan menampilkan respons JSON.

Untuk pengujian dari terminal:

curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"

Untuk frontend, perlakukan URL tersebut seperti endpoint API biasa. Setelah backend siap, Anda dapat mengganti base URL tanpa harus mengubah bentuk respons yang dikonsumsi UI.

Amankan mock dengan autentikasi token

URL publik memudahkan kolaborasi, tetapi mock untuk fitur yang belum dirilis atau integrasi mitra mungkin perlu dibatasi.

Buka:

Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock

Lalu ubah izin akses menjadi Autentikasi Token.

Setelah diaktifkan, request harus menyertakan apidogToken yang valid. Request tanpa token akan ditolak.

Opsi 1: token sebagai parameter query

curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"

Opsi ini praktis untuk uji cepat di browser, tetapi token dapat muncul di riwayat browser atau log URL.

Opsi 2: token sebagai header

Untuk aplikasi frontend atau request otomatis, header biasanya lebih aman karena token tidak dimasukkan ke URL.

curl "https://mock.apidog.com/m1/2689726-0-default/users" \
  -H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"

Contoh dengan fetch:

const response = await fetch(
  "https://mock.apidog.com/m1/2689726-0-default/users",
  {
    headers: {
      apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi",
    },
  }
);

const users = await response.json();

Opsi 3: token dalam body form

Token juga dapat dikirim sebagai parameter body bernama apidogToken untuk request form-data atau x-www-form-urlencoded.

Jika Anda mengaktifkan Autentikasi Token setelah URL dibagikan, koordinasikan perubahan tersebut dengan consumer API. Semua consumer harus menambahkan token agar request mereka tidak gagal.

Hasilkan data realistis yang peka wilayah dengan locale

Mock dengan nilai seperti "name": "string" hanya memvalidasi bentuk data. Sebaliknya, nama, alamat, nomor telepon, dan waktu yang terlihat realistis membantu frontend menemukan masalah UI lebih awal, seperti:

• teks yang terlalu panjang;
• format alamat yang berbeda;
• karakter non-Latin;
• layout yang rusak pada nama atau kota tertentu;
• format tanggal dan waktu yang tidak sesuai wilayah.

Apidog menggunakan Faker.js untuk menghasilkan data mock. Anda dapat mengatur locale pada beberapa tingkat.

Gunakan locale default proyek

Secara default, Faker mengikuti bahasa proyek. Atur di:

Pengaturan Proyek > Pengaturan Dasar

Bahasa yang dipilih akan menjadi locale default untuk nilai mock yang dihasilkan.

Misalnya, ketika proyek menggunakan bahasa Prancis, data nama dan alamat mock akan mengikuti karakteristik locale tersebut tanpa konfigurasi tambahan per field.

Timpa locale untuk seluruh proyek

Jika data mock harus menggunakan locale yang berbeda dari bahasa proyek, buka:

Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock

Pilih locale Faker dari dropdown. Pengaturan ini berlaku untuk semua endpoint dan field dalam proyek.

Gunakan pendekatan ini saat menguji internasionalisasi. Misalnya, gunakan locale Jepang untuk memeriksa apakah UI menangani skrip non-Latin dan format alamat yang berbeda dengan benar.

Untuk detail pembuatan data berbasis schema, baca panduan mock pintar Apidog dan cara membaca skemanya.

Timpa locale per field

Anda juga dapat menentukan locale untuk satu field tertentu. Ini berguna untuk respons yang mewakili pengguna dari beberapa wilayah.

{{$person.fullName(locale='ja')}}

Ekspresi tersebut dapat menghasilkan nama Jepang seperti:

田中 太郎

Prioritas locale:

1. Locale tingkat field.
2. Locale tingkat proyek pada Pengaturan Mock.
3. Bahasa default pada Pengaturan Dasar.

Gunakan override per field hanya ketika diperlukan agar konfigurasi tetap mudah dipelihara.

Dokumentasi menunjukkan ja sebagai contoh. Konfirmasikan kode locale untuk wilayah target Anda melalui dokumentasi mock Apidog dan referensi localization Faker.js.

Atur zona waktu mock

Jika respons API memuat timestamp seperti createdAt, atur zona waktu agar data mock konsisten dengan wilayah yang diuji.

Konfigurasi default tersedia di:

Pengaturan Proyek > Pengaturan Fitur > Pengaturan Mock

Untuk kebutuhan spesifik, gunakan parameter timeZone dalam ekspresi mock pada field terkait.

Kombinasi locale dan zona waktu membantu Anda membuat skenario yang lebih realistis, misalnya untuk pengguna Jepang, Jerman, atau basis pengguna internasional campuran. Lihat juga kasus penggunaan API mocking praktis.

Cloud Mock vs mock yang di-hosting sendiri

Cloud Mock cocok jika tim membutuhkan endpoint mock yang selalu aktif tanpa harus mengelola infrastruktur.

Gunakan Cloud Mock ketika Anda membutuhkan:

• URL publik yang dapat dibagikan;
• setup cepat;
• mock yang mengikuti desain API;
• akses stabil untuk frontend, QA, dan mitra.

Namun, organisasi dengan kebijakan residensi data atau pembatasan lalu lintas ke cloud vendor mungkin perlu menjalankan mock di infrastruktur sendiri. Pendekatannya memberi kendali lebih besar, tetapi tim juga bertanggung jawab atas deployment dan operasional layanan tersebut.

Untuk skenario ini, baca panduan hosting sendiri server mock Apidog. Jika Anda sedang mengevaluasi beberapa pilihan, lihat perbandingan alat API mocking online.

Untuk ketersediaan fitur berdasarkan akun atau paket, periksa langsung workspace Anda. Anda dapat mengunduh Apidog dan mencoba alur Cloud Mock dari awal hingga akhir.

Otomatiskan alur kerja dengan Apidog CLI

Cloud Mock adalah layanan yang di-hosting Apidog. Artinya, Apidog CLI tidak digunakan untuk menjalankan atau melayani server mock dari terminal.

Peran CLI adalah menjaga spesifikasi API dan pengujian tetap sinkron dengan mock:

1. Perbarui endpoint dan schema API di proyek.
2. Cloud Mock menghasilkan respons berdasarkan schema tersebut.
3. Gunakan CLI untuk menjalankan skenario pengujian terhadap environment backend saat implementasi sudah tersedia.
4. Pastikan backend tetap memenuhi kontrak yang sebelumnya digunakan frontend melalui mock.

Contoh menjalankan skenario:

apidog run -t <scenario_id> -e <env_id> -r cli

Perintah tersebut menjalankan skenario pengujian tersimpan terhadap environment tertentu dan melaporkan hasilnya.

Praktiknya, buka skenario di Apidog lalu salin perintah yang sudah menyertakan nilai -t untuk ID skenario dan -e untuk ID environment. Jangan menebak ID atau menyusun flag secara manual.

Dengan pendekatan ini:

• frontend mulai bekerja menggunakan Cloud Mock;
• kontrak API berkembang bersama schema;
• backend diuji terhadap kontrak yang sama;
• pipeline CI/CD dapat memvalidasi implementasi sebelum rilis.

Untuk integrasi pipeline, baca panduan menjalankan Apidog dalam pipeline CI/CD.

FAQ

Apakah URL Cloud Mock tetap berfungsi saat Apidog ditutup?

Ya. Cloud Mock di-hosting oleh infrastruktur Apidog, bukan oleh mesin lokal Anda. URL tetap tersedia meskipun laptop Anda dimatikan atau Apidog tidak terbuka.

Bisakah URL Cloud Mock dibuka langsung di browser?

Bisa untuk request GET. Tempelkan URL lengkap ke browser untuk melihat respons JSON.

Jika token digunakan, Anda dapat menambahkan token sebagai query parameter. Untuk penggunaan aplikasi atau agar token tidak muncul di riwayat URL, kirim token melalui header.

Apa yang terjadi jika request tidak menyertakan token?

Jika izin akses menggunakan Autentikasi Token, request tanpa apidogToken valid akan ditolak.

Kirim token melalui salah satu cara berikut:

• parameter query;
• request header;
• parameter body pada request formulir.

Bagaimana cara membuat data mock untuk negara tertentu?

Pilih salah satu tingkat konfigurasi berikut:

• atur bahasa proyek pada Pengaturan Dasar;
• atur locale seluruh proyek pada Pengaturan Fitur > Pengaturan Mock;
• gunakan parameter locale pada field tertentu.

Contoh override field:

{{$person.fullName(locale='ja')}}

Locale tingkat field memiliki prioritas tertinggi. Untuk konteks schema-aware generation, lihat panduan mock pintar.

Haruskah menggunakan Cloud Mock atau alat mock headless?

Gunakan Cloud Mock jika Anda membutuhkan endpoint yang di-hosting, mudah dibagikan, dan terhubung ke desain API di Apidog.

Jika kebutuhan Anda adalah mock yang sepenuhnya berjalan dalam build otomatis tanpa GUI, lihat survei alat mock headless. Banyak alat dalam kategori ini menggunakan konsep yang terkait dengan spesifikasi OpenAPI Initiative, sehingga kontrak API yang bersih tetap menjadi fondasi utama.

Kesimpulan

Mock lokal hanya membantu selama mesin pengembang aktif. Cloud Mock mengubah kontrak API menjadi URL publik mock.apidog.com yang dapat digunakan seluruh tim.

Untuk menerapkannya:

1. Desain endpoint dan schema respons.
2. Aktifkan Cloud Mock.
3. Uji respons mock.
4. Bagikan URL kepada frontend dan QA.
5. Aktifkan autentikasi token jika akses perlu dibatasi.
6. Atur locale dan zona waktu untuk data uji yang lebih realistis.
7. Jalankan skenario CLI untuk memvalidasi backend terhadap kontrak yang sama.

Dengan alur ini, frontend tidak perlu menunggu backend untuk mulai membangun. Unduh Apidog untuk membuat Cloud Mock pertama yang dapat dibagikan.