Konsep Inti
Setelah empat desain ini Anda pahami, setiap protokol dan skenario berikutnya menjadi mudah:
- Model tiga entitas: bagaimana Grup / Lingkungan / Permintaan saling berhubungan
- Desain Pre-URL lingkungan: mengapa permintaan hanya menyimpan path relatif
- Alur perakitan pengiriman: bagaimana satu kali Send mengubah konfigurasi menjadi permintaan nyata
- Sistem variabel: dari mana
{{variable}}diselesaikan, dan tiga lapis variabel
Model Tiga Entitas
Mengapa lingkungan diikat ke grup, bukan ke setiap permintaan? Sebuah grup biasanya mewakili "semua API dari satu modul di bawah satu target penerapan". Pengikatan di tingkat grup berarti berpindah lingkungan memindahkan seluruh grup sekaligus — tanpa mengedit per permintaan. Jika satu permintaan membutuhkan lingkungan berbeda, cukup letakkan di grup yang terikat ke lingkungan tersebut.
Desain Pre-URL Lingkungan
Ini adalah desain yang paling penting — dan paling sering disalahpahami.
Permintaan menyimpan path relatif; lingkungan menyimpan alamat dasar
Pada alat tradisional setiap permintaan menyimpan URL lengkap (https://api.example.com/v1/users), sehingga berpindah ke lingkungan pengujian berarti mengganti domain secara massal. Alat ini membaliknya:
Skema menentukan protokol dan TLS (kunci!)
Pre-URL disimpan per protokol, tetapi protokol apa yang benar-benar dilayani suatu entri ditentukan oleh skema di awal URL. Skema menyatakan sekaligus "protokol mana" dan "terenkripsi atau tidak (TLS)":
| Protokol | Skema plain | Skema terenkripsi |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Kesalahan umum: alamat dasar WebSocket harus ditulis sebagai
ws:///wss://. Jika Anda mengetikhttps://, itu diperlakukan sebagai HTTP dan permintaan WebSocket gagal karena tidak memiliki alamat dasar. Jaga konsistensi baris protokol dan skema.
Alur Perakitan Pengiriman
Menekan "Send" tidak langsung menembakkan socket. Alur ini merakit "permintaan + lingkungan grup + variabel" langkah demi langkah menjadi permintaan nyata, dan menyisipkan rantai aksi sebelum serta sesudah panggilan jaringan:
Poin penting:
- Rantai aksi hanya berjalan saat "execute scripts" aktif. Menekan Send di aplikasi menjalankannya secara default; pengiriman otomatis / MCP harus mengaktifkannya secara eksplisit. Dengan skrip nonaktif, token yang disuntik pra-kirim atau enkripsi sama sekali tidak terjadi — itulah mengapa kontrol negatif "no token → 401" di resep berperilaku demikian.
- Skrip pra-kirim menulis ulang permintaan yang akan keluar; skrip pasca-respons menulis ulang respons yang Anda terima. Keduanya dapat membaca dan menulis variabel runtime.
Sistem Variabel
Ada tiga jenis "variabel" dengan cakupan berbeda. Mencampuradukkannya adalah jebakan paling umum bagi pemula.
Apa yang sebenarnya dapat diselesaikan oleh {{name}}?
| Ditulis di mana | Variabel lingkungan | Variabel runtime | Penggunaan tipikal |
|---|---|---|---|
{{name}} (di URL / params / headers / body) | ✅ | ❌ | Referensi konfigurasi lingkungan, pengisian dinamis |
| Membaca variabel di dalam skrip | ✅ | ✅ | Meneruskan token login antar permintaan, dll. |
Mnemonik:
{{}}hanya melihat variabel "tipe konfigurasi"; skrip dapat membaca ketiga lapis. Variabel runtime adalah "papan runtime" — hanya skrip yang bisa mencoret di sana, dan{{}}tidak pernah melihat ke sana.
Mengapa {{authToken}} tidak bisa membaca token yang disimpan saat login? Karena skrip login menyimpannya di lapisan runtime, yang tidak diurai oleh {{}}. Pendekatan yang benar adalah skrip pra-kirim yang membacanya dan menyuntikkan header (lihat resep, skenario 1).
Variabel dinamis {{$xxx}}
Di dalam {{}} juga ada sekumpulan variabel dinamis bawaan, dibuat baru pada setiap evaluasi, dapat langsung digunakan di URL / params / headers / body:
| Variabel | Menghasilkan |
|---|---|
{{$timestamp}} / {{$timestampMs}} | Stempel waktu Unix dalam detik / milidetik |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | Bilangan bulat acak (bawaan 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} dll. | Aneka contoh data acak |
Contoh: GET /echo?ts={{$timestamp}}&u={{$uuid}} — dalam praktiknya setiap pengiriman mengganti ts/u dengan nilai nyata yang baru.
Ringkasan
- Permintaan menyimpan fragmen path; lingkungan menyediakan alamat dasar per protokol melalui Pre-URL; skema menentukan protokol + TLS.
- Pengiriman adalah alur perakitan: gabungkan URL → interpolasi → pengaturan transport → rantai pra-kirim → jaringan → rantai pasca-respons.
- Variabel ada dalam tiga lapis:
{{}}membaca variabel tipe konfigurasi, skrip membaca ketiganya; teruskan token dengan skrip, bukan{{}}.
Berikutnya: scripting →