Watch-IP

Referensi API geolokasi pengunjung

GET/v1/geo

Mengembalikan lokasi dan data pengayaan yang tersedia untuk klien yang terhubung. Panggil dari browser pengunjung untuk menjelaskan koneksi pengunjung tersebut — request dari server aplikasi Anda justru menjelaskan koneksi server itu sendiri.

Autentikasi

Sediakan publishable key yang dikunci origin lewat header X-Api-Key, atau parameter query key sebagai alternatif. Kontrol akses berasal dari daftar allowed-origins yang dikonfigurasi untuk key tersebut, dicocokkan dengan header Origin/Referer dari request — bukan dari menjaga kerahasiaan key-nya, karena memang dirancang untuk muncul di source browser.

Field respons

ip
Alamat IP klien yang terhubung.
country, region, regionCode, city, postalCode, continent
Lokasi perkiraan, bernilai null saat data edge yang mendasarinya tidak menyelesaikan satu pun.
latitude, longitude
Koordinat perkiraan untuk lokasi yang terselesaikan, bukan posisi perangkat atau GPS.
timezone
Nama timezone IANA, atau null saat tidak tersedia.
isEUCountry
Boolean; sebuah flag lokasional, bukan penentuan hukum.
asn, asOrganization
Jaringan yang terhubung dan operatornya, jika disediakan oleh data yang mendasarinya; jika tidak, null.
currency, callingCode
Konteks regional yang diturunkan dari country yang terselesaikan, atau null.
locale, holidays, compliance, tax, ageVerification
Kelompok pengayaan turunan yang opsional, masing-masing nullable secara independen. Tidak satu pun dari ini adalah penentuan hukum, pajak, atau identitas.
hostname
Hanya ada saat diminta lewat ?include=hostname; hasil pencarian PTR, null jika gagal.
security
Dihilangkan sepenuhnya pada paket yang tidak menyertakannya. Jika ada: isTor, isVpn, isDatacenter, isThreat, isSanctionedNetwork — indikator berbasis daftar. Deteksi Tor IPv6 saat ini belum diimplementasikan; false berarti tidak ada kecocokan pada data yang tersedia, bukan tidak adanya risiko.

Error

401
API key hilang atau tidak valid.
403
Origin/Referer request ini tidak ada di daftar allowed-origins key tersebut. Tidak ada header CORS yang diset pada respons ini, sehingga browser memblokirnya terlepas dari isi JSON-nya.
429
Rate limit terlampaui untuk jendela tetap satu menit saat ini.

Contoh

Request

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

Respons — ilustratif; field bervariasi menurut paket dan data yang tersedia

{
  "ip": "203.0.113.1",
  "country": "US",
  "region": "Texas",
  "regionCode": "TX",
  "city": "Austin",
  "postalCode": "78701",
  "latitude": 30.2672,
  "longitude": -97.7431,
  "continent": "NA",
  "timezone": "America/Chicago",
  "isEUCountry": false,
  "asn": 12345,
  "asOrganization": "Example ISP",
  "currency": { "code": "USD", "name": "US Dollar", "symbol": "$" },
  "callingCode": "+1"
}

Batas

Tunduk pada batas request bulanan dan rate limit per menit paket Anda — lihat harga. Setiap panggilan yang berhasil dicatat sebagai satu event penggunaan geo.

Halaman terkait