Skip to main content
L’API di Enrow utilizza l’autenticazione tramite chiave API. Ogni richiesta deve includere la tua chiave API nell’header x-api-key. Non ci sono flussi OAuth o token bearer da gestire: una sola chiave API autentica ogni endpoint.

Come ottengo la mia chiave API?

  1. Registrati su app.enrow.io
  2. Clicca su API nel menu a sinistra
  3. Copia la tua chiave API
Mantieni al sicuro la tua chiave API e non inserirla mai nel controllo di versione. Trattala come una password. Se una chiave viene esposta, ruotala: vedi Best practice.

Come autentico una richiesta?

Includi la tua chiave API nell’header x-api-key di ogni richiesta:
Lo stesso header x-api-key funziona per ogni endpoint: Email Finder, Email Verifier, Phone Finder e Informazioni account.

Perché ricevo un errore 401?

Una risposta 401 Unauthorized significa che la tua chiave API è mancante o non valida. Se la chiave API non è valida, riceverai:
Se non viene fornita alcuna chiave API, il message sarà invece "No apikey found in the x-api-key headers". Per l’elenco completo dei codici di stato e dei formati di errore, vedi Codici di stato e Gestione degli errori.

Come verifico il mio account e i miei crediti?

Puoi recuperare le informazioni del tuo account (saldo dei crediti e webhook registrati) usando lo stesso header x-api-key: non è necessario alcun payload nel corpo:
Response
Per capire come vengono consumati i crediti per ciascun endpoint, vedi Crediti e fatturazione.

Best practice

Memorizza la tua chiave API nelle variabili d’ambiente anziché inserirla direttamente nel codice:
Per una maggiore sicurezza, ruota periodicamente le tue chiavi API e revoca quelle inutilizzate.
Crea chiavi API separate per gli ambienti di sviluppo, staging e produzione.

Passaggi successivi

Trova un'email

Cerca un indirizzo email professionale a partire da un nome e un’azienda.

Verifica un'email

Controlla se un indirizzo email è valido e recapitabile.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.

Limiti di frequenza

Comprendi i limiti delle richieste API prima di scalare.