Watch-IP

Autenticazione

Watch-IP utilizza due tipi di chiave a seconda dell'endpoint che stai chiamando: una chiave pubblicabile, sicura per il browser, per le chiamate lato client, e una chiave segreta, riservata al server, per le chiamate di backend. Inviare il tipo sbagliato restituisce 401 o 403, mai una risposta parziale.

Chiavi pubblicabili (sicure per il browser)

Usata per GET /v1/geo e POST /v1/email/validate — entrambe pensate per essere chiamate direttamente dal browser di un visitatore. Inviala come header X-Api-Key (GET /v1/geo accetta anche un parametro di query key come alternativa). Non è un segreto: viene distribuita nel JavaScript della tua pagina, e il controllo che conta davvero è la lista delle origini consentite configurata per la chiave, verificata rispetto all'header Origin/Referer della richiesta. Una richiesta proveniente da un'origine non presente in quella lista riceve un 403 senza alcun header CORS impostato — il browser blocca la risposta prima ancora che il tuo codice la veda, ed è questa l'applicazione effettiva del controllo, non il corpo JSON dell'errore.

Chiave pubblicabile

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

Chiavi segrete (solo server)

Usata per GET /v1/lookup/{ip}, POST /v1/lookup e POST /v1/risk/check — tutti endpoint da server a server, senza alcuna Origin di browser da verificare. Inviala come Authorization: Bearer YOUR_SECRET_KEY solo dal tuo backend; non incorporare mai una chiave segreta in una pagina, in un bundle di un'app mobile o in qualsiasi client che non controlli direttamente. Usare una chiave pubblicabile su una rotta che richiede una chiave segreta, o viceversa, restituisce 403.

Chiave segreta

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

Limite di frequenza

Ogni chiave è soggetta a un limite di frequenza per account cliente, calcolato su una finestra fissa di un minuto e condiviso tra tutti gli endpoint che chiami, non tracciato per singola rotta. Superarlo restituisce 429 — consulta errori e limiti di frequenza per la forma della risposta e come gestire i tentativi successivi. Il limite di frequenza al minuto conta le chiamate HTTP, non gli elementi: un batch fino a 100 IP o indirizzi email conta come una sola richiesta, mentre ogni elemento continua a contare separatamente nel limite mensile di richieste.

Domini personalizzati

I piani Growth e Scale includono un percorso di configurazione per un dominio personalizzato nella dashboard, così le richieste possono essere indirizzate a un hostname sul tuo dominio invece che ad api.watch-ip.com. La disponibilità dipende dall'idoneità dell'account e dal completamento della configurazione DNS/SSL — punta la tua integrazione verso qualunque URL di base la dashboard confermi come attivo.

Pagine correlate