Vai al contenuto principale
Le impostazioni API controllano come accedi all’API Enrow e come si comporta a ogni richiesta. Questa pagina spiega chi può accedere all’API, dove trovare la tua chiave API, come impostare un URL webhook predefinito e come il parametro country_code modifica il comportamento della ricerca.

​
Chi può accedere all’API Enrow?

L’API Enrow è disponibile per i clienti con un abbonamento attivo o crediti pay-as-you-go. Se il tuo account non dispone di nessuno dei due, la sezione API non sarà accessibile. Per vedere come vengono consumati i crediti per ciascun endpoint, consulta Crediti e fatturazione.

​
Dove trovo la mia chiave API?

La tua chiave API si trova nella Enrow Dashboard — fai clic su API nel menu a sinistra e copia la chiave. La stessa chiave autentica ogni endpoint tramite l’header x-api-key. Per esempi di richieste e gestione degli errori, consulta Autenticazione.
Mantieni al sicuro la tua chiave API. Non inserire mai la chiave API nel controllo di versione né condividerla pubblicamente. Trattala come una password.

​
Come imposto un URL webhook predefinito?

Puoi configurare un URL webhook predefinito nella dashboard. Questo URL viene utilizzato ogni volta che non viene specificato alcun webhook in una singola richiesta, così non devi ripeterlo a ogni chiamata. Un webhook per singola richiesta nell’oggetto settings sovrascrive sempre il valore predefinito della dashboard. Per i formati dei payload, i nuovi tentativi e la sicurezza, consulta Come funzionano i webhook.

​
Cosa fa il parametro country_code?

Il parametro country_code (ISO 3166-1 alpha-2) imposta quale versione locale di Google l’API utilizza per risolvere un’azienda. Passalo nell’oggetto settings della tua richiesta. Se non viene fornito nulla, il valore predefinito è US.
Il codice paese è utile solo quando si effettua una ricerca con company_name (non company_domain). Indica a Enrow quale versione locale di Google utilizzare per risolvere l’azienda — ad esempio, google.de per la Germania o google.fr per la Francia.
Il codice paese è particolarmente utile per gli omonimi — aziende che condividono lo stesso nome in paesi diversi: 
// Dove the soap brand (UK)
{
  "company_name": "Dove",
  "fullname": "John Doe",
  "settings": { "country_code": "GB" }
}

// Dove the chocolate brand (Germany)
{
  "company_name": "Dove",
  "fullname": "Hans Müller",
  "settings": { "country_code": "DE" }
}
L’oggetto settings accetta anche webhook (un URL webhook per singola richiesta), retrieve_gender (booleano) e retrieve_company_info (booleano). Consulta il riferimento Find Single Email per l’elenco completo delle impostazioni disponibili.

​
FAQ

No. Un’unica chiave API autentica ogni endpoint — Email Finder, Email Verifier e Phone Finder. Passa la chiave nell’header x-api-key a ogni richiesta.
No. Il parametro country_code influisce solo sulle ricerche che utilizzano company_name. Quando passi un company_domain, il dominio identifica già l’azienda, quindi il codice paese non ha alcun effetto.
Il webhook per singola richiesta nell’oggetto settings ha la priorità. Il valore predefinito della dashboard viene utilizzato solo quando una richiesta non include un proprio URL webhook.

​
Prossimi passi

Autenticazione

Come passare la tua chiave API nell’header x-api-key.

Come funzionano i webhook

Configura i webhook per ricevere una notifica al completamento di una ricerca.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.

Trova un'email

Esegui una singola ricerca di email con impostazioni personalizzate.