Mock Kustom

Apidog menyediakan fitur kustomisasi mock yang andal yang memberi Anda kontrol terperinci atas respons API. Dokumen ini memperkenalkan dua pendekatan untuk menyesuaikan data mock:

Kustomisasi Tingkat Field: Mengontrol field tertentu sambil menggunakan smart mock untuk field lainnya

Kustomisasi Respons Penuh: Menentukan respons mock lengkap dengan ekspektasi (tetap, kondisional, atau dinamis)

Kustomisasi Tingkat Field

Terkadang Anda perlu menentukan nilai spesifik untuk field tertentu sambil membiarkan Apidog secara otomatis menghasilkan sisanya. Apidog menawarkan metode fleksibel untuk kontrol tingkat field.

Mengatur Nilai Field Kustom

1. Nilai Tetap

Tentukan nilai statis di field mock pada spesifikasi endpoint. Apidog akan selalu mengembalikan nilai persis ini untuk field tersebut, sambil menggunakan smart mock untuk field yang tidak ditentukan.

Contoh:

2. Nilai Dinamis dengan Faker.js

Hasilkan data acak yang realistis menggunakan nilai dinamis Apidog (berdasarkan Faker.js). Gunakan sintaks:

{{$category.method}}

Contoh Umum:

Ekspresi	Contoh Hasil
`{{$person.fullName}}`	Rachel Wheeler
`{{$internet.email}}`	Arno.Huels33@yahoo.com
`{{$commerce.productName}}`	Elegant Plastic Bike

Pilih nilai dinamis langsung dari menu dropdown:

3. Metode Faker Berparameter

Teruskan parameter ke metode nilai dinamis untuk pembuatan data khusus menggunakan sintaks Faker.js yang disempurnakan oleh Apidog.

Contoh:

Kasus Penggunaan	Ekspresi	Deskripsi
Rentang integer	`{{$number.int(min=0,max=10000)}}`	Integer acak antara 0 dan 10.000
Telepon yang mudah dibaca	`{{$phone.number(style='human')}}`	Format telepon yang mudah dibaca manusia
Kelipatan N	`{{$number.int(multipleOf=3)}}`	Integer yang dapat dibagi 3
Elemen array	`{{$helpers.arrayElement(['red','blue','green'])}}`	Warna acak dari array
Rentang tanggal	`{{$date.between(from='2024-01-01',to='2024-12-31',format='yyyy-MM-dd')}}`	Tanggal di antara rentang yang ditentukan

Jelajahi daftar lengkap modul, metode, dan parameter dalam dokumentasi Modul Nilai Dinamis.

4. Menggabungkan Beberapa Ekspresi

Gabungkan teks statis dan beberapa ekspresi dinamis untuk menghasilkan nilai field yang kompleks.

Contoh: Pembuatan Alamat Lengkap

{{$location.streetAddress}}, {{$location.city}}, {{$location.state}}, {{$location.zipCode}}, {{$location.country}}

Contoh Output:

8507 Hudson Alley, Rochester, Wisconsin, 96512, United States

Setiap komponen dihasilkan secara dinamis, sehingga menciptakan alamat yang unik dan realistis untuk setiap panggilan API mock.

Locale Mock

Apidog mendukung locale mock yang dapat disesuaikan, sehingga Anda dapat menghasilkan data pengujian dinamis dalam berbagai bahasa dan format yang sesuai dengan wilayah atau audiens target Anda. Untuk mempelajari lebih lanjut tentang konfigurasi locale mock, kunjungi Bahasa mock (Locales).

Kustomisasi Respons Penuh (Ekspektasi Mock)

Untuk kontrol lengkap atas respons mock, gunakan ekspektasi mock. Fitur ini memungkinkan Anda menentukan respons tetap, kondisional, atau dinamis.

Membuat Ekspektasi Mock

Respons Tetap

Kembalikan data yang sama untuk setiap permintaan dengan membuat ekspektasi tanpa syarat.

Langkah-langkah:

Klik New expectation

Tambahkan nama ekspektasi dan biarkan kondisi kosong

Isi data respons yang ingin Anda kembalikan, lalu simpan

Salin dan gunakan URL mock yang disediakan untuk mengakses endpoint ini

Respons Kondisional

Kembalikan data mock yang berbeda berdasarkan parameter permintaan. Mesin mock mengevaluasi kondisi dari atas ke bawah, lalu mengembalikan ekspektasi pertama yang cocok.

Jenis Kondisi yang Didukung:

Jenis Parameter	Deskripsi
Parameter query	String query URL
Parameter path	Segmen URL dinamis
Parameter header	Header HTTP
Parameter cookie	Nilai cookie
Parameter body	Field body JSON (melalui path JSON)

Perilaku Kondisi

Beberapa kondisi digabungkan dengan logika AND (semuanya harus cocok)

Jika tidak ada kondisi yang cocok, Apidog kembali menggunakan prioritas metode Mock di Project Settings → Feature Settings → Mock Settings

Batasan

Parameter body hanya mendukung JSON, bukan XML

Kondisi parameter tidak dapat menggunakan {{variables}}

Format body permintaan harus sesuai dengan spesifikasi API (misalnya, form-data, JSON)

Kondisi alamat IP dapat membatasi respons ke IP tertentu

Data Mock Dinamis

Ekspektasi mock mendukung data dinamis dan acak menggunakan sintaks templat Faker.js dan Nunjucks.

Contoh:

{
    "data": [
        {% for i in range(0, 20) %}
        {% if i>1 %},{% endif %}
        {
            "id": {{i}},
            "firstname": "{{$person.firstName}}",
            "lastname": "{{$person.lastName}}"
        }
        {% endfor %}
    ],
    "success": true
}

Ini menghasilkan:

Array berisi 20 objek pengguna (id dari 0 hingga 19)

Masing-masing dengan nama depan dan nama belakang yang dihasilkan secara acak

Field konstan "success": true

Catatan Sintaks:

Sintaks	Tujuan
`{{$...}}`	Memanggil Faker.js untuk nilai acak
`{% for ... %}`	Struktur loop Nunjucks
`{{i}}`	Variabel loop Nunjucks (bukan variabel Apidog)

Perbedaan Penting

Apidog menggunakan {{$person.firstName}} alih-alih Faker.js native faker.person.firstName()

Variabel proyek/lingkungan Apidog ({{variable}}) tidak tersedia dalam ekspektasi mock

Lihat dokumentasi Faker.js dan Nunjucks untuk sintaks lengkap

Fitur Lanjutan

Header Respons Kustom

Tambahkan header kustom ke ekspektasi mock untuk menyimulasikan autentikasi, paginasi, atau perilaku API lainnya.

Properti Respons Lanjutan

Konfigurasikan properti respons tambahan di tab More:

Properti	Tujuan	Default
HTTP Status Code	Menyimulasikan kesalahan atau kasus khusus	200
Response Delay	Menyimulasikan latensi jaringan (milidetik)	0

Mengaktifkan/Menonaktifkan Ekspektasi

Alihkan ekspektasi aktif atau nonaktif secara independen untuk lingkungan mock lokal dan cloud dari daftar ekspektasi.

Ringkasan

Fitur mock kustom Apidog menyediakan:

Kustomisasi field yang fleksibel dengan nilai tetap atau dinamis

Kontrol respons penuh melalui ekspektasi mock

Logika kondisional untuk respons berbasis parameter

Pembuatan data dinamis menggunakan Faker.js dan Nunjucks

Simulasi lanjutan dengan header kustom, penundaan, dan kode status

Fitur-fitur ini memungkinkan Anda membuat simulasi API yang tangguh dan berketepatan tinggi yang secara akurat mencerminkan perilaku produksi!

Kustomisasi Tingkat Field#

Mengatur Nilai Field Kustom#

1. Nilai Tetap#

2. Nilai Dinamis dengan Faker.js#

3. Metode Faker Berparameter#

4. Menggabungkan Beberapa Ekspresi#

Kustomisasi Respons Penuh (Ekspektasi Mock)#

Membuat Ekspektasi Mock#

Respons Tetap#

Respons Kondisional#

Data Mock Dinamis#

Fitur Lanjutan#

Header Respons Kustom#

Properti Respons Lanjutan#

Mengaktifkan/Menonaktifkan Ekspektasi#

Ringkasan#

Kustomisasi Tingkat Field

Mengatur Nilai Field Kustom

1. Nilai Tetap

2. Nilai Dinamis dengan Faker.js

3. Metode Faker Berparameter

4. Menggabungkan Beberapa Ekspresi

Kustomisasi Respons Penuh (Ekspektasi Mock)

Membuat Ekspektasi Mock

Respons Tetap

Respons Kondisional

Data Mock Dinamis

Fitur Lanjutan

Header Respons Kustom

Properti Respons Lanjutan

Mengaktifkan/Menonaktifkan Ekspektasi

Ringkasan