Snelstart

Voordat je begint

• Een Watch-IP-account — het gratis abonnement is genoeg om deze handleiding te volgen.
• Een pagina of script waaraan je een fetch- of curl-aanroep kunt toevoegen.

1. Maak een account aan en haal een sleutel op

Meld je aan en open je dashboard. Elk account begint met een publiceerbare bezoekerssleutel — configureer de toegestane origins zodat deze de site bevatten waarvandaan je hem gaat aanroepen (of localhost tijdens het testen).

2. Doe je eerste verzoek

Roep GET /v1/geo aan met je publiceerbare sleutel in de X-Api-Key-header. Vanuit een browser bepaalt dit de eigen verbinding van de bezoeker; vanaf een server bepaalt het in plaats daarvan de eigen verbinding van de server.

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

3. Lees het antwoord

Een geslaagde aanroep geeft 200 terug met een JSON-body — country, city en timezone zijn de velden waar de meeste integraties mee beginnen, en elk veld kan onafhankelijk null zijn, dus controleer voordat je er een gebruikt.

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

4. Zoek een ander IP op

Moet je een adres opzoeken dat je al hebt, in plaats van de verbindende bezoeker? Dat is een apart server-naar-server-endpoint dat wordt geauthenticeerd met een geheime sleutel, niet je publiceerbare sleutel — zie de IP-lookup-referentie.

Als er iets misgaat

Een 401 betekent dat de API-sleutel ontbreekt of ongeldig is; een 403 van GET /v1/geo betekent meestal dat de aanroepende origin nog niet op de lijst met toegestane origins van de sleutel staat. Zie foutmeldingen en ratelimieten voor de volledige lijst met statuscodes.

Volgende stap

Lees authenticatie voor hoe sleuteltypen en origin-beperking werken, of ga direct naar de endpointreferentie voor het antwoord waarmee je integreert.