> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Impostazioni API

> Configura l'accesso all'API Enrow, la tua chiave API, un URL webhook predefinito e il parametro country_code dalla dashboard

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](/it/credits-billing).

## Dove trovo la mia chiave API?

La tua chiave API si trova nella [Enrow Dashboard](https://app.enrow.io) — 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](/it/authentication).

<Warning>
  Mantieni al sicuro la tua chiave API. Non inserire mai la chiave API nel controllo di versione né condividerla pubblicamente. Trattala come una password.
</Warning>

## 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](/it/how-webhooks-work).

## 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`.

<Info>
  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.
</Info>

Il codice paese è particolarmente utile per gli **omonimi** — aziende che condividono lo stesso nome in paesi diversi:

```json theme={null}
// 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](/it/api-reference/email-finder/find-single) per l'elenco completo delle impostazioni disponibili.

## FAQ

<AccordionGroup>
  <Accordion title="Mi serve una chiave API separata per ogni endpoint?">
    No. Un'unica chiave API autentica ogni endpoint — [Email Finder](/it/api-reference/email-finder/find-single), [Email Verifier](/it/api-reference/email-verifier/verify-single) e [Phone Finder](/it/api-reference/phone/find-single). Passa la chiave nell'header `x-api-key` a ogni richiesta.
  </Accordion>

  <Accordion title="country_code funziona con company_domain?">
    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.
  </Accordion>

  <Accordion title="Cosa succede se imposto sia un webhook nella dashboard sia un webhook per singola richiesta?">
    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`.
  </Accordion>
</AccordionGroup>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Autenticazione" icon="key" href="/it/authentication">
    Come passare la tua chiave API nell'header x-api-key.
  </Card>

  <Card title="Come funzionano i webhook" icon="bell" href="/it/how-webhooks-work">
    Configura i webhook per ricevere una notifica al completamento di una ricerca.
  </Card>

  <Card title="Crediti e fatturazione" icon="coins" href="/it/credits-billing">
    Scopri come vengono consumati i crediti per ciascun endpoint.
  </Card>

  <Card title="Trova un'email" icon="envelope" href="/it/api-reference/email-finder/find-single">
    Esegui una singola ricerca di email con impostazioni personalizzate.
  </Card>
</CardGroup>