Skip to main content
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 impostare un URL webhook predefinito nella pagina API della dashboard. Enrow controlla l’URL quando lo salvi: consulta Come verifico il mio endpoint webhook?. Questo URL viene utilizzato ogni volta che non viene specificato alcun webhook in una singola richiesta, così non devi ripeterlo a ogni chiamata. Quando una richiesta include invece un webhook nel proprio oggetto settings, questo sostituisce il valore predefinito della dashboard per le richieste Phone Finder ed Email Verifier. Per le richieste Email Finder, Enrow notifica entrambi gli URL. Per i formati dei payload, le consegne 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:
L’oggetto settings accetta anche webhook (un URL webhook per singola richiesta) e retrieve_gender (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.
Dipende dall’endpoint. Per le ricerche Email Finder, Enrow invia il risultato a entrambi gli URL (una sola volta se coincidono). Per le ricerche Phone Finder e le verifiche Email Verifier, il webhook per singola richiesta nell’oggetto settings sostituisce il valore predefinito della dashboard, che 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.