Variabel memungkinkan Anda memberikan nama pada sebuah nilai dan menggunakannya kembali di mana pun Anda membutuhkannya.
Misalnya, alih-alih menempelkan token API yang sering berubah ke setiap permintaan, definisikan variabel seperti ACCESS_TOKEN dan gunakan {{ACCESS_TOKEN}} dalam permintaan Anda. Saat token kedaluwarsa, perbarui variabel sekali dan semua permintaan yang menggunakannya akan secara otomatis mengambil nilai baru.
Sekilas Jenis Variabel
Apidog mendukung beberapa jenis variabel, masing-masing dirancang untuk skenario tertentu. Anda dapat menggunakan: variabel global tingkat tim, variabel global tingkat proyek, variabel modul, variabel lingkungan, variabel data pengujian, dan variabel lokal.
Variabel Global
Variabel global memungkinkan Anda berbagi data secara luas. Ada dua jenis:
Variabel Global Tingkat Proyek: Terbatas pada proyek saat ini. Sempurna untuk meneruskan data antar permintaan dalam proyek yang sama. Misalnya, simpan token dari titik akhir login sebagai variabel global tingkat proyek, lalu gunakan kembali dalam permintaan lain di dalam proyek tersebut.
Variabel Global Tingkat Tim: Dibagikan di semua proyek dalam satu tim. Ideal untuk kolaborasi lintas proyek. Misalnya, jika layanan otentikasi mengeluarkan token yang digunakan oleh beberapa proyek, simpan sebagai variabel global tim.
Catatan Izin: Anggota biasa hanya dapat melihat dan mengubah nilai saat ini dari variabel global tingkat tim yang sudah ada. Mereka tidak dapat menambah/menghapus variabel atau mengganti namanya. Hanya admin tim yang dapat sepenuhnya mengelola variabel tingkat tim di Sumber Daya Tim → Variabel.
Variabel Modul
Variabel modul dicakup ke modul tertentu. Jika Anda mengimpor Koleksi Postman, variabel koleksinya diimpor sebagai variabel modul Apidog.
Variabel ini sangat bagus untuk konfigurasi khusus modul. Misalnya, sebuah proyek mungkin memiliki modul terpisah untuk pengguna, pesanan, dan produk—masing-masing dapat menyimpan konfigurasinya sendiri dalam variabel modul.
Pastikan Apidog Anda diperbarui untuk menggunakan variabel modul.
Variabel Lingkungan
Variabel lingkungan kemungkinan adalah jenis yang paling sering Anda gunakan. Variabel ini memungkinkan Anda beralih antar lingkungan tanpa mengubah konfigurasi untuk setiap permintaan.
Dalam praktiknya, Anda biasanya memiliki beberapa lingkungan (lokal, pengujian, staging, produksi). Masing-masing memiliki alamat server, koneksi database, atau konfigurasi pihak ketiga yang berbeda. Dengan variabel lingkungan, Anda dapat beralih di antara keduanya secara instan.
Catatan: Hanya satu lingkungan yang dapat aktif pada satu waktu. Saat Anda memilih lingkungan, semua variabel yang didefinisikan di dalamnya akan berlaku.
Variabel Data Pengujian
Variabel data pengujian mendukung pengujian berbasis data. Ketika Anda perlu menguji titik akhir yang sama dengan banyak set data, inilah teman Anda.
Siapkan file CSV atau JSON dengan beberapa baris (atau objek). Dalam skenario pengujian otomatis, impor file tersebut, dan Apidog akan mengulang setiap baris sebagai satu set variabel dan menjalankan pengujian untuk setiap baris.
Variabel Lokal
Variabel lokal memiliki masa pakai terpendek—hanya berlaku selama satu permintaan atau eksekusi pengujian. Variabel ini akan hilang setelah eksekusi.
Karena variabel lokal memiliki prioritas tertinggi, variabel ini sempurna untuk menimpa jenis variabel lain secara sesaat. Misalnya, lingkungan Anda mendefinisikan user_id, tetapi untuk satu pengujian khusus, Anda memerlukan nilai yang berbeda—atur variabel lokal dengan nama yang sama alih-alih mengubah lingkungan.
Prioritas Variabel
Ketika beberapa variabel memiliki nama yang sama, Apidog menyelesaikannya berdasarkan prioritas (tertinggi ke terendah): Variabel Lokal > Variabel Data Pengujian > Variabel Lingkungan > Variabel Modul > Variabel Global Tingkat Proyek > Variabel Global Tingkat Tim
Contoh: Jika Anda mendefinisikan tiga variabel bernama userId:
- Variabel global tingkat proyek
userId = 1000 - Variabel modul:
userId = 2000 - Variabel lingkungan:
userId = 3000
Ketika Anda menggunakan {{userId}} dalam sebuah permintaan, nilai yang efektif adalah 3000 (dari lingkungan). Jika tidak ada nilai lingkungan, itu akan kembali ke nilai modul (2000), lalu ke nilai global proyek (1000).
Nilai Awal vs Nilai Saat Ini
Variabel global, modul, dan lingkungan memiliki nilai awal dan nilai saat ini—ini menyeimbangkan berbagi tim dengan privasi pribadi.
- Nilai awal berada di server Apidog dan disinkronkan dengan rekan tim. Gunakan untuk konfigurasi bersama, seperti URL server pengujian dan kunci API publik.
- Nilai saat ini hanya ada di perangkat Anda. Gunakan untuk rahasia seperti kunci API pribadi, kata sandi, atau pengaturan lingkungan pribadi.
Ketika nilai saat ini ada, Apidog lebih memilihnya. Jika nilai saat ini kosong, Apidog menggunakan nilai awal. Ingin nilai saat ini mengikuti nilai awal? Klik ikon tautan di sebelah nilai saat ini untuk mengikat ulang.
Nilai saat ini disimpan di perangkat Anda dan dapat hilang jika Anda menghapus cache atau beralih perangkat. Dalam versi web Apidog, nilai tersebut disimpan di browser. Untuk berpindah ke perangkat baru, ekspor/impor lingkungan untuk memigrasikan nilai saat ini.
Catatan: Saat menjalankan pengujian otomatis dengan Apidog CLI, perhatikan perbedaan utama: Klien Apidog menggunakan nilai saat ini selama eksekusi, sedangkan CLI menggunakan nilai awal. Jika hasilnya berbeda antara klien dan CLI, ini adalah alasan umum.
Cara Mengatur Variabel
Pilih metode yang paling sesuai dengan asal nilai dan bagaimana Anda akan menggunakannya.
Atur Variabel Langsung di Halaman Manajemen Lingkungan
Metode yang paling mudah. Klik tombol Manajemen Lingkungan (kanan atas), beralih ke global atau lingkungan tertentu, lalu tambahkan nama dan nilai.
Metode ini sangat bagus untuk konfigurasi stabil seperti koneksi database. Anda dapat mengatur nilai awal (bersama) dan nilai saat ini (pribadi).
Gunakan Fitur "Simpan Variabel"
Seringkali, nilai variabel berasal dari respons—seperti token dari titik akhir login atau ID pengguna dari titik akhir buat pengguna. Gunakan "Simpan Variabel" visual di Post Processor untuk mengatur variabel baru.
Di Post Processor permintaan, tambahkan "Simpan Variabel", pilih sumber (umumnya respons JSON), dan pilih bidang menggunakan JSONPath.
Misalnya, jika JSON respons adalah:
{
"user": {
"id": "69",
"email": "Ralph85@gmail.com",
"first_name": "Katlynn",
"last_name": "Reichert",
"api_token": "dolore ut mollit Duis sit",
"created_at": "2025-09-19T01:03:50.236Z",
"updated_at": "2025-05-10",
"deleted_at": "2025-09-18T18:30:51.217Z",
"role": "developer",
"metadata": {}
}
}Gunakan $.user.email untuk mengekstrak token.
Anda juga dapat mengatur variabel langsung dari bagian respons permintaan.
Atur Variabel melalui Skrip
Untuk logika yang lebih kompleks, gunakan Skrip Kustom di Pre Processor atau Post Processor. Apidog menyediakan API skrip lengkap untuk memanipulasi semua jenis variabel.
// Atur variabel global tingkat proyek
pm.globals.set('variable_key', 'variable_value');
// Atur variabel global tingkat tim (harus didefinisikan di halaman Sumber Daya Tim terlebih dahulu)
pm.globals.set('variable_key', 'variable_value', 'TEAM');
// Atur variabel lingkungan
pm.environment.set('variable_key', 'variable_value');
// Atur variabel modul
pm.moduleVariables.set('variable_key', 'variable_value');
// Atur variabel lokal
pm.variables.set('variable_key', 'variable_value');Saat menyimpan objek atau array, ubah menjadi string terlebih dahulu dan uraikan saat membaca. Contoh:
pm.environment.set('user', JSON.stringify(userObj));
const users = JSON.parse(pm.environment.get('user'));Catatan: Skrip hanya dapat mengatur nilai saat ini dari variabel. Nilai awal harus diatur di Halaman Manajemen Lingkungan.
Gunakan Data Database sebagai Variabel
Apidog dapat mengambil data langsung dari database dan mengaturnya sebagai variabel—sangat bagus untuk pengujian yang mengandalkan catatan nyata.
Tambahkan Operasi Database di Post Processor, konfigurasikan koneksi, dan tulis SQL. Kemudian ekstrak bidang ke dalam variabel menggunakan JSONPath.
Tips Menggunakan Variabel
Di Mana Variabel Bekerja
Variabel hanya diselesaikan ketika permintaan benar-benar dikirim. Itu berarti Anda dapat menggunakannya di header, parameter, body, skenario pengujian, dan skrip—di mana pun yang terlibat dalam pengiriman permintaan.
Karena Apidog mengutamakan visual, aturan praktis yang sederhana: jika Anda melihat tombol "Nilai Dinamis", Anda dapat menggunakan variabel di sana.
Sintaks Dasar
Gunakan kurung kurawal ganda untuk merujuk variabel: {{namaVariabel}}. Ini berfungsi di URL, header, parameter, dan body.
Misalnya, di parameter:
Dan di body:
Catatan untuk body JSON: variabel string memerlukan tanda kutip, variabel numerik tidak. Kurung kurawal ganda dapat memicu peringatan lint JSON, tetapi dapat diabaikan dengan aman.
Jika Anda melihat "variabel tidak terpecahkan", jangan panik. Variabel yang diatur di Post Processor atau skrip mungkin tidak ada sampai permintaan berjalan, dan variabel lokal menghilang setelah berjalan. Cara terbaik untuk mengonfirmasi adalah dengan benar-benar mengirim permintaan.
Mengambil Bidang Turunan dari Variabel
Terkadang variabel Anda menyimpan objek atau array, bukan hanya string atau angka. Misalnya, API pengguna sering mengembalikan objek dengan id, nama, email, dll.
Misalkan Anda menyimpan objek respons ini sebagai variabel bernama user:
{
"id": 1001,
"name": "Joe",
"email": "joe@example.com",
"role": "admin"
}Anda dapat merujuk bidang tertentu dengan notasi titik, seperti {{user.id}} (1001) atau {{user.name}} ("Joe").
Untuk array, caranya serupa. Jika Anda memiliki variabel users:
[
{"id": 1001, "name": "Joe"},
{"id": 1002, "name": "Rio"},
{"id": 1003, "name": "Outher"}
]Gunakan {{users[0].name}} untuk mendapatkan nama pengguna pertama, atau {{users[1].id}} untuk ID pengguna kedua.
Ini mengikuti semantik seperti JSONPath—nama variabel bertindak seperti root ($).
Gunakan Variabel dalam Skrip
Anda dapat menggunakan variabel dalam skrip kustom Pre Processor atau Post Processor. Apidog menyediakan set lengkap API skrip, memungkinkan Anda untuk secara fleksibel mengakses berbagai jenis variabel.
// Dapatkan variabel global tingkat proyek
pm.globals.get('variable_key');
// Dapatkan variabel global tingkat tim
pm.globals.get('variable_key', 'TEAM');
// Dapatkan variabel lingkungan
pm.environment.get('variable_key');
// Dapatkan variabel modul
pm.moduleVariables.get('variable_key');
// Dapatkan variabel lokal
pm.variables.get('variable_key');Untuk objek/array yang disimpan sebagai string, uraikan terlebih dahulu:
const userObj = JSON.parse(pm.environment.get('user'));
console.log(userObj.name);Pengujian Berbasis Data dengan Variabel Data Pengujian
Unggah file CSV atau JSON yang berisi beberapa baris data. Selama eksekusi, Apidog mengganti {{namaVariabel}} dengan nilai dari setiap baris dan menjalankan pengujian sekali per baris—sempurna untuk memvalidasi ketahanan dengan banyak masukan.
Ekspresi Nilai Dinamis
Selain variabel Anda sendiri, Apidog mendukung nilai dinamis, yang menghasilkan data acak mengikuti aturan tertentu.
Dalam skrip, Anda dapat memproses string yang menyertakan ekspresi dinamis dengan await pm.variables.replaceInAsync():
const template = "Halo, {{$person.fullName}}";
const result = await pm.variables.replaceInAsync(template);
console.log(result); // Mengeluarkan nama yang dihasilkan secara acak
Nilai dinamis sempurna untuk menghasilkan data pengujian acak tanpa menyiapkan dataset sebelumnya.
Ringkasan
Variabel adalah salah satu fitur paling ampuh di Apidog. Variabel mengurangi pengulangan, membuat pengujian fleksibel, dan menyederhanakan peralihan antar proyek dan lingkungan. Baik Anda berbagi pengaturan global di seluruh tim, menjalankan pengujian dengan data CSV, atau menimpa nilai secara lokal, variabel membantu menjaga alur kerja Anda tetap efisien dan terorganisir. Dengan menguasai jenis variabel, prioritas, dan cara mengaturnya, Anda dapat memastikan permintaan API Anda tetap konsisten, mudah dipelihara, dan siap untuk skenario dunia nyata.