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 la tua chiave viene esposta, reimpostala: 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:
Il tuo account ha un’unica chiave API e, in un team, tutto il team la condivide. Non esiste una chiave separata per ambiente o per membro, quindi conservala in un secret manager e caricala da lì in ogni ambiente.
Il titolare dell’account (in un team, il proprietario del team) può reimpostare la chiave dalla pagina API con Reset API key. La chiave precedente viene invalidata, quindi aggiornala ovunque la utilizzi.

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.