API-referentie voor bezoekersgeolocatie

GET/v1/geo

Geeft de beschikbare locatie- en verrijkingsgegevens van de verbindende client terug. Roep dit aan vanuit de browser van een bezoeker om de verbinding van die bezoeker te beschrijven — een verzoek vanaf de server van je eigen applicatie beschrijft in plaats daarvan de verbinding van de server zelf.

Authenticatie

Geef een aan de origin gebonden publiceerbare sleutel mee via de X-Api-Key-header, of als alternatief de key-queryparameter. Toegangscontrole komt van de lijst met toegestane origins die voor de sleutel is ingesteld, gecontroleerd tegen de Origin/Referer-header van het verzoek — niet van het geheimhouden van de sleutel, aangezien deze bedoeld is om in de broncode van de browser te verschijnen.

Antwoordvelden

ip: Het IP-adres van de verbindende client.
country, region, regionCode, city, postalCode, continent: Geschatte locatie, nullable wanneer de onderliggende edge-data er geen kan herleiden.
latitude, longitude: Geschatte coördinaten voor de herleide locatie, geen apparaat- of gps-positie.
timezone: IANA-tijdzonenaam, of null wanneer niet beschikbaar.
isEUCountry: Boolean; een locatie-indicatie, geen juridische vaststelling.
asn, asOrganization: Het verbindende netwerk en de beheerder ervan, wanneer geleverd door de onderliggende data; anders null.
currency, callingCode: Regionale context afgeleid van het herleide land, of null.
locale, holidays, compliance, tax, ageVerification: Optionele afgeleide verrijkingsgroepen, elk onafhankelijk van elkaar nullable. Geen van deze zijn juridische, fiscale of identiteitsvaststellingen.
hostname: Alleen aanwezig wanneer opgevraagd via ?include=hostname; het resultaat van een reverse-DNS-opzoeking, null als deze mislukt.
security: Volledig weggelaten bij plannen die het niet bevatten. Indien aanwezig: isTor, isVpn, isDatacenter, isThreat, isSanctionedNetwork — op lijsten gebaseerde indicatoren. IPv6-Tor-detectie is momenteel niet geïmplementeerd; false betekent geen match in de beschikbare data, niet de afwezigheid van risico.

Foutmeldingen

401: Ontbrekende of ongeldige API-sleutel.
403: De Origin/Referer van het verzoek staat niet op de lijst met toegestane origins van de sleutel. Er wordt geen CORS-header op dit antwoord gezet, dus de browser blokkeert het ongeacht de JSON-inhoud.
429: Rate limit overschreden voor het huidige, vaste venster van één minuut.

Voorbeeld

Verzoek

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

Antwoord — ter illustratie; velden verschillen per plan en beschikbare data

{
  "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"
}

Limieten

Onderhevig aan de maandelijkse verzoeklimiet en de rate limit per minuut van je plan — zie prijzen. Elke geslaagde aanroep wordt geregistreerd als één geo-gebruiksgebeurtenis.