Watch-IP

Panduan cepat

Jalankan panggilan GET /v1/geo yang berfungsi dalam beberapa menit: buat key, kirim request, dan baca responsnya.

Sebelum Anda mulai

  • Akun Watch-IP — paket Free sudah cukup untuk mengikuti panduan ini.
  • Halaman atau skrip tempat Anda bisa menambahkan panggilan fetch atau curl.

1. Buat akun dan dapatkan key

Daftar dan buka dashboard Anda. Setiap akun dimulai dengan publishable visitor key — konfigurasikan allowed origins-nya agar mencakup situs tempat Anda akan memanggilnya (atau localhost saat menguji).

2. Kirim request pertama Anda

Panggil GET /v1/geo dengan publishable key Anda di header X-Api-Key. Dari browser, ini akan menyelesaikan koneksi pengunjung itu sendiri; dari server, ini akan menyelesaikan koneksi server itu sendiri.

curl

curl https://api.watch-ip.com/v1/geo \
  -H "X-Api-Key: YOUR_PUBLISHABLE_KEY"

3. Baca responsnya

Panggilan yang berhasil mengembalikan 200 dengan isi JSON — country, city, dan timezone adalah field yang biasanya menjadi awal bagi kebanyakan integrasi, dan setiap field bisa bernilai null secara independen, jadi periksa dulu sebelum menggunakannya.

Respons (dipersingkat)

{
  "ip": "203.0.113.1",
  "country": "US",
  "city": "Austin",
  "timezone": "America/Chicago"
}

4. Mencari IP lain

Perlu menyelesaikan alamat yang sudah Anda miliki, bukan pengunjung yang sedang terhubung? Itu adalah endpoint server-ke-server terpisah yang diautentikasi dengan secret key, bukan publishable key Anda — lihat referensi pencarian IP.

Jika terjadi kesalahan

401 berarti API key hilang atau tidak valid; 403 dari GET /v1/geo biasanya berarti origin pemanggil belum ada di daftar allowed-origins key tersebut. Lihat halaman error dan rate limit untuk daftar lengkap kode status.

Langkah berikutnya

Baca halaman autentikasi untuk memahami cara kerja jenis key dan penguncian origin, atau langsung ke referensi endpoint untuk respons yang sedang Anda integrasikan.

Halaman terkait