Watch-IP

Authenticatie

Watch-IP gebruikt twee soorten sleutels, afhankelijk van welk endpoint je aanroept — een publiceerbare sleutel die veilig is voor de browser bij client-side aanroepen, en een geheime sleutel die alleen server-side wordt gebruikt voor backend-aanroepen. Het versturen van het verkeerde type levert 401 of 403 op, nooit een gedeeltelijk antwoord.

Publiceerbare sleutels (veilig voor de browser)

Wordt gebruikt voor GET /v1/geo en POST /v1/email/validate — beide ontworpen om rechtstreeks vanuit de browser van een bezoeker te worden aangeroepen. Stuur de sleutel mee als de X-Api-Key-header (GET /v1/geo accepteert ook een key-queryparameter als terugvaloptie). Het is geen geheim: de sleutel staat gewoon in de JavaScript van je pagina, en de controle die telt is de lijst met toegestane origins die voor de sleutel is ingesteld, gecontroleerd tegen de Origin/Referer-header van het verzoek. Een verzoek vanaf een origin die niet op die lijst staat, krijgt een 403 zonder dat er een CORS-header wordt gezet — de browser blokkeert het antwoord voordat je eigen code het ooit te zien krijgt, en dát is de daadwerkelijke handhaving, niet de JSON-foutmelding.

Publiceerbare sleutel

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

Geheime sleutels (alleen server-side)

Wordt gebruikt voor GET /v1/lookup/{ip}, POST /v1/lookup en POST /v1/risk/check — allemaal server-naar-server-endpoints zonder browser-Origin om te controleren. Stuur de sleutel alleen vanaf je eigen backend mee als Authorization: Bearer YOUR_SECRET_KEY; embed nooit een geheime sleutel in een pagina, een mobiele-appbundel of een client waar je geen controle over hebt. Het gebruiken van een publiceerbare sleutel op een route voor geheime sleutels, of andersom, levert 403 op.

Geheime sleutel

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

Rate limiting

Elke sleutel wordt per klantaccount begrensd binnen een vast venster van één minuut, gedeeld over elk endpoint dat je aanroept in plaats van per route bijgehouden. Overschrijding levert 429 op — zie foutmeldingen en rate limits voor de vorm van het antwoord en hoe je moet terugschakelen. De rate limit per minuut telt HTTP-aanroepen, geen items: een batch van maximaal 100 IP's of e-mailadressen telt als één verzoek, terwijl elk item nog steeds apart meetelt voor de maandelijkse verzoeklimiet.

Aangepaste domeinen

Growth- en Scale-plannen bevatten een instelpad voor een aangepast domein in het dashboard, zodat verzoeken naar een hostnaam op je eigen domein kunnen gaan in plaats van naar api.watch-ip.com. Beschikbaarheid hangt af van de geschiktheid van je account en een succesvolle DNS/SSL-instelling — richt je integratie op welke basis-URL je dashboard ook als actief bevestigt.

Gerelateerde pagina's