Vai al contenuto principale
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: 
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "John Doe",
    "company_domain": "example.com"
  }'
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: 
{
  "message": "This apikey is not valid"
}
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: 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
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:
export ENROW_API_KEY="your_api_key_here"
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.