Watch-IP

Autentikasi

Watch-IP menggunakan dua jenis key tergantung endpoint mana yang Anda panggil — publishable key yang aman untuk browser untuk panggilan sisi klien, dan secret key khusus server untuk panggilan backend. Mengirim jenis yang salah akan mengembalikan 401 atau 403, tidak pernah respons parsial.

Publishable key (aman untuk browser)

Digunakan untuk GET /v1/geo dan POST /v1/email/validate — keduanya dirancang untuk dipanggil langsung dari browser pengunjung. Kirim sebagai header X-Api-Key (GET /v1/geo juga menerima parameter query key sebagai cadangan). Ini bukan rahasia: key ini ikut terkirim dalam JavaScript halaman Anda, dan kontrol yang sebenarnya berlaku adalah daftar allowed-origins yang dikonfigurasi untuk key tersebut, dicocokkan dengan header Origin/Referer dari request. Request dari origin yang tidak ada dalam daftar tersebut akan mendapat 403 tanpa header CORS yang diset — browser memblokir respons sebelum kode Anda sempat melihatnya, dan itulah penegakan yang sebenarnya, bukan isi error JSON-nya.

Publishable key

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

Secret key (khusus server)

Digunakan untuk GET /v1/lookup/{ip}, POST /v1/lookup, dan POST /v1/risk/check — semuanya endpoint server-ke-server tanpa Origin browser untuk diperiksa. Kirim sebagai Authorization: Bearer YOUR_SECRET_KEY hanya dari backend Anda sendiri; jangan pernah menyematkan secret key di halaman, bundel aplikasi mobile, atau klien apa pun yang tidak Anda kendalikan. Menggunakan publishable key pada rute secret-key, atau secret key pada rute publishable-key, akan mengembalikan 403.

Secret key

curl https://api.watch-ip.com/v1/lookup/203.0.113.1 \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

Rate limit

Setiap key dibatasi rate-nya per akun pelanggan dalam jendela tetap satu menit, dibagi bersama di antara semua endpoint yang Anda panggil, bukan dilacak per rute. Melebihi batas ini mengembalikan 429 — lihat halaman error dan rate limit untuk bentuk responsnya dan cara melakukan back off. Rate limit per menit menghitung panggilan HTTP, bukan item: satu batch berisi hingga 100 IP atau alamat email dihitung sebagai satu request, sementara setiap item tetap dihitung terpisah terhadap batas request bulanan.

Domain kustom

Paket Growth dan Scale menyertakan jalur pengaturan domain kustom di dashboard, sehingga request dapat diarahkan ke hostname di domain Anda sendiri, bukan api.watch-ip.com. Ketersediaannya tergantung kelayakan akun dan keberhasilan pengaturan DNS/SSL — arahkan integrasi Anda ke base URL mana pun yang dikonfirmasi aktif oleh dashboard Anda.

Halaman terkait