Panduan4 menit baca

Setting proxy di Postman: HTTP, auth, dan sesi sticky

Cara pasang residential proxy di Postman: custom proxy HTTP/HTTPS, taruh target lokasi di username, sesi sticky, dan jalankan koleksi lewat Newman.

Postman dipakai banyak tim untuk menguji API, cek respons endpoint, dan reproduksi bug. Tapi API sering menjawab berbeda tergantung lokasi pemanggil: harga per negara, konten yang di-geoblock, respons CDN yang beda per wilayah, atau fitur yang baru aktif di pasar tertentu. Kalau kamu menguji dari satu kota saja, kamu cuma melihat satu versi. Supaya request Postman keluar lewat IP rumahan di negara yang kamu mau, arahkan Postman ke proxy residential WaroengProxy. Semua diatur di satu tempat, menu proxy Postman, tanpa plugin atau ekstensi tambahan, dan tanpa mengubah satu baris pun di koleksimu.

Endpoint dan format yang dipakai Postman

Semua protokol WaroengProxy memakai satu endpoint, proxy.waroengproxy.com:8000, untuk HTTP, HTTPS, dan SOCKS5. Target lokasi tidak ditulis di host atau port, melainkan di username. Host dan port tetap sama; yang berubah hanya username. Baris lengkapnya seperti ini:

Username
# IP Indonesia
USERNAME-cc-ID:PASSWORD@proxy.waroengproxy.com:8000
# IP Indonesia, sesi sticky 10 menit
USERNAME-cc-ID-s-sesi1-ttl-600:PASSWORD@proxy.waroengproxy.com:8000

Di Postman, host (proxy.waroengproxy.com) dan port (8000) masuk ke kolom proxy server, sedangkan username (termasuk parameter target) dan password masuk ke kolom proxy auth. Beda HTTP, HTTPS, dan SOCKS5 dibahas di HTTP, HTTPS, atau SOCKS5?, dan daftar lengkap parameter target ada di Target negara, kota, sampai ISP.

Pasang custom proxy di Postman

Postman desktop punya pengaturan proxy sendiri yang berlaku untuk semua request di aplikasi. Langkahnya:

  1. Buka Settings (ikon gerigi di kanan atas), lalu pindah ke tab Proxy.
  2. Matikan Use the system proxy bila aktif, lalu nyalakan Add a custom proxy configuration.
  3. Pada Proxy Type, centang HTTP dan HTTPS. Satu proxy HTTP sudah cukup untuk menguji API https://, karena Postman membuka terowongan CONNECT sehingga TLS tetap langsung antara Postman dan server tujuan.
  4. Isi Proxy Server: host proxy.waroengproxy.com dan port 8000.
  5. Aktifkan Proxy auth, lalu isi Username dengan USERNAME-cc-ID (ganti USERNAME dengan milikmu) dan Password dengan password proxy dari dashboard.
  6. Simpan, lalu kirim GET https://ipinfo.io/json untuk memastikan IP, kota, dan jaringan yang terlihat sudah sesuai target.
Custom proxy Postman hanya untuk HTTP/HTTPS. Kalau butuh SOCKS5, pasang endpoint yang sama sebagai proxy sistem lalu pilih Use the system proxy di Postman. Untuk menguji API biasa, proxy HTTP di atas sudah cukup.

Taruh target lokasi di kolom username

Semua penargetan ditulis di kolom Username proxy, dengan pola kunci lalu nilai yang dipisah tanda minus. Setiap tambahan filter mempersempit pilihan IP:

Username
# Amerika Serikat
USERNAME-cc-US
# Indonesia, kota Jakarta
USERNAME-cc-ID-ct-Jakarta
# Amerika Serikat, California, jaringan Comcast
USERNAME-cc-US-st-CA-isp-comcast

Kota ditulis tanpa spasi dan aksen, kode negara/wilayah huruf besar, dan nama ISP huruf kecil tanpa kata korporat. Semua parameter berlaku bersamaan, jadi -cc-US-st-CA berarti IP di Amerika Serikat sekaligus di California. Kalau mau menyusun username ini otomatis, memeriksa formatnya, lalu menyalinnya, pakai Generator proxy di dashboard supaya tidak salah ketik.

Satu nilai yang salah membuat seluruh username ditolak dengan error 407. Mulai dari filter paling longgar (misalnya hanya negara), baru persempit kalau perlu. Hindari kombinasi mustahil seperti -cc-ID-ct-Tokyo.

Sesi sticky untuk alur bertahap

Secara default proxy bersifat rotating: tiap request bisa keluar dari IP berbeda. Untuk alur yang butuh IP tetap, misalnya login lalu beberapa panggilan API berurutan, tambahkan -s- dengan label bebas dan -ttl- dengan durasi dalam detik:

Username
# IP sama selama 10 menit, label sesi1
USERNAME-cc-ID-s-sesi1-ttl-600:PASSWORD@proxy.waroengproxy.com:8000
# sesi lain, IP berbeda
USERNAME-cc-ID-s-sesi2-ttl-600:PASSWORD@proxy.waroengproxy.com:8000

TTL bisa 1 sampai 86400 detik (24 jam), bawaannya 60 detik. Tulis label hanya dengan huruf dan angka, tanpa tanda minus, karena minus adalah pemisah di username. Label yang sama selalu kembali ke IP yang sama selama TTL berjalan.

Ganti negara dan batasan satu proxy global

Pengaturan proxy Postman berlaku global untuk seluruh aplikasi, bukan per request, dan tidak membaca variabel koleksi. Beberapa cara menyiasatinya:

  • Untuk membandingkan beberapa negara, ubah bagian -cc- pada kolom Username di Settings, lalu kirim ulang request yang sama. Catat IP, kota, dan URL akhir tiap kali.
  • Untuk alur paralel yang tidak boleh tercampur, pakai label sticky berbeda per alur (-s-sesi1, -s-sesi2).
  • Untuk pengujian otomatis dan berulang, jalankan koleksi lewat Newman (CLI) dengan variabel lingkungan proxy yang berbeda per proses, seperti di bawah.

Jalankan koleksi lewat Newman

Newman, runner baris perintah Postman, menghormati variabel lingkungan proxy standar HTTP_PROXY dan HTTPS_PROXY. Jadi target bisa diganti tanpa mengutak-atik Settings aplikasi:

Contoh
# Linux / macOS
export HTTPS_PROXY="http://USERNAME-cc-ID:PASSWORD@proxy.waroengproxy.com:8000"
export HTTP_PROXY="http://USERNAME-cc-ID:PASSWORD@proxy.waroengproxy.com:8000"
newman run koleksi.json
# Windows PowerShell
$env:HTTPS_PROXY = "http://USERNAME-cc-ID:PASSWORD@proxy.waroengproxy.com:8000"
newman run koleksi.json

Untuk menguji dua negara, jalankan dua kali dengan nilai -cc- berbeda, atau bungkus dalam skrip yang mengulang beberapa negara. Karena penagihan berbasis data yang lewat, bukan jumlah IP atau lama pakai, matikan unduhan yang tidak perlu dan jangan pasang proxy untuk request yang tidak butuh lokasi khusus. Respons API yang ramping biasanya kecil, jadi pengujian rutin pun hemat kuota.

Kalau gagal

  • 407 Proxy Authentication Required: username atau password salah, atau ada parameter target yang keliru. Periksa huruf besar/kecil dan ejaan kota/ISP. Langkah rincinya ada di Proxy error 407, timeout, atau IP salah negara?.
  • Timeout atau koneksi ditolak saat filter ketat: tidak ada IP yang cocok dengan semua filter sekaligus. Longgarkan satu filter, misalnya dari kota ke negara.
  • Error sertifikat SSL: biarkan verifikasi SSL tetap aktif. Proxy residential menjaga TLS tetap antara Postman dan server tujuan, jadi error sertifikat biasanya soal endpoint tujuan, bukan proxy-nya.
  • Semua request lambat atau gagal setelah sebelumnya jalan: cek sisa kuota GB di dashboard, lalu pastikan host dan port masih benar.

Setelah ini Postman mengeluarkan request lewat IP rumahan sesuai target yang kamu pilih. Gunakan hanya untuk menguji API dan endpoint yang memang boleh kamu akses, dan patuhi ToS layanan serta robots.txt bila relevan. Lihat harga per GB dan fitur lengkapnya, atau langsung buat akun untuk mulai.