Watch-IP

Referensi API pencarian IP

GET/v1/lookup/{ip}

Menyelesaikan satu alamat IPv4 atau IPv6 yang Anda kirim, menggunakan database geolokasi IP dan ASN pihak ketiga — sumber data dan bentuk respons yang berbeda dari GET /v1/geo. Khusus server-ke-server; panggil dari backend Anda, jangan pernah dari browser.

Autentikasi

Sediakan secret key lewat Authorization: Bearer YOUR_SECRET_KEY. Berbeda dari publishable key yang dipakai GET /v1/geo, key ini harus tetap berada di server Anda — menggunakan publishable key di sini akan mengembalikan 403.

Field respons

ip
Alamat IP yang Anda kirim, dikembalikan apa adanya.
country, city, continent
Lokasi perkiraan dari database sumber, atau null saat tidak tersedia.
region
Kode subdivisi (misalnya "TX"), bukan nama wilayah — bentuk yang berbeda dari field region milik GET /v1/geo.
postalCode, timezone
Tidak diisi oleh database sumber saat ini — selalu null.
latitude, longitude
Koordinat perkiraan, atau null saat tidak tersedia.
found
False saat IP tersebut tidak punya record yang cocok atau database yang mendasarinya sedang tidak tersedia — kedua kasus ini tidak dibedakan dalam field ini.

Error

400
IP yang dikirim bukan alamat IPv4 atau IPv6 yang valid.
401
API key hilang atau tidak valid.
403
Publishable key digunakan, bukan secret key.
429
Rate limit terlampaui untuk jendela satu menit saat ini.

Contoh

Request

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

Respons

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "TX",
  "city": "Austin",
  "postalCode": null,
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": null,
  "found": true
}

Batas

Ditagih per IP yang dicari, terpisah dari volume request paket geo pengunjung Anda — lihat halaman produk pencarian IP untuk harga dan ketersediaan. Butuh lebih dari satu IP per panggilan? Gunakan endpoint batch. Data lokasi untuk endpoint ini disediakan oleh DB-IP (IP Geolocation by DB-IP, db-ip.com — CC BY 4.0).

Halaman terkait