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

# Utilizzo

> Monitora l'utilizzo dell'API Enrow e il consumo di crediti e ottimizza le richieste con endpoint bulk, webhook e caching

Questa pagina spiega come monitorare l'utilizzo dell'API Enrow e il consumo di crediti, e come ottimizzare le tue richieste per spendere meno crediti. Per capire come vengono tariffati i crediti per ciascun endpoint, consulta [Crediti e fatturazione](/it/credits-billing).

## Come posso monitorare l'utilizzo della mia API?

Puoi monitorare l'utilizzo dell'API Enrow in due modi: visivamente nella dashboard oppure in modo programmatico tramite l'endpoint dell'account.

### Dove posso vedere l'utilizzo nella dashboard?

La [Dashboard Enrow](https://app.enrow.io) offre una visione in tempo reale del tuo utilizzo:

* Crediti consumati nel tempo
* Suddivisione per endpoint
* Tassi di successo e di errore
* Crediti rimanenti

### Come verifico l'utilizzo tramite l'API?

Interroga l'endpoint dell'account per verificare l'utilizzo in modo programmatico. Autentica la richiesta con la tua [chiave API](/it/authentication) nell'header `x-api-key` — non è necessario alcun payload nel corpo:

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Response theme={null}
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
```

Il valore `credits` è il tuo saldo rimanente, mentre `webhooks` elenca gli URL registrati sul tuo account. Consulta il riferimento [Informazioni account](/it/api-reference/account/info) per lo schema completo della risposta.

## Come posso ottimizzare l'utilizzo della mia API?

Per ridurre il consumo di crediti e rimanere entro i tuoi [limiti di frequenza](/it/rate-limits), raggruppa le tue richieste con gli endpoint bulk, ricevi i risultati tramite webhook anziché tramite polling e memorizza nella cache i risultati che hai già recuperato.

<AccordionGroup>
  <Accordion title="Usa gli endpoint bulk">
    Invece di effettuare molte richieste singole, raggruppale (fino a 5.000 voci per richiesta bulk di email, 3.000 per richiesta bulk di telefoni):

    ```javascript theme={null}
    // ❌ 100 separate requests
    for (const contact of contacts) {
      await findEmail(contact);
    }

    // ✅ 1 bulk request
    await findEmailsBulk(contacts);
    ```

    Consulta [Trova email](/it/api-reference/email-finder/find-bulk) e [Trova telefoni](/it/api-reference/phone/find-bulk) per le operazioni in batch.
  </Accordion>

  <Accordion title="Usa i webhook anziché il polling">
    Il polling spreca crediti e quota dei limiti di frequenza. Usa i webhook per ricevere automaticamente i risultati:

    ```json theme={null}
    {
      "fullname": "John Doe",
      "company_domain": "example.com",
      "settings": {
        "webhook": "https://your-app.com/webhook"
      }
    }
    ```

    Scopri come funziona la consegna in [Come funzionano i webhook](/it/how-webhooks-work).
  </Accordion>

  <Accordion title="Memorizza i risultati nella cache">
    Memorizza i risultati per evitare chiamate API ridondanti per lo stesso contatto.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="L'endpoint di utilizzo costa crediti?">
    No. Interrogare l'endpoint [Informazioni account](/it/api-reference/account/info) restituisce i tuoi crediti rimanenti e i webhook registrati senza consumare alcun credito.
  </Accordion>

  <Accordion title="Le ricerche fallite consumano crediti?">
    I crediti vengono consumati secondo le regole descritte in [Crediti e fatturazione](/it/credits-billing). Quando una richiesta fallisce prima dell'elaborazione — ad esempio una risposta `402 Insufficient credits` — non viene detratto alcun credito. Consulta [Gestione degli errori](/it/error-handling) e [Codici di stato](/it/status-codes) per i formati delle risposte.
  </Accordion>

  <Accordion title="Come posso evitare di raggiungere i limiti di frequenza?">
    Raggruppa le tue richieste con gli endpoint bulk e usa i webhook anziché il polling per ottenere i risultati. Entrambi riducono il numero di chiamate che effettui. Consulta [Limiti di frequenza](/it/rate-limits) per gli attuali limiti delle richieste.
  </Accordion>
</AccordionGroup>

## Prossimi passi

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

  <Card title="Informazioni account" icon="circle-user" href="/it/api-reference/account/info">
    Recupera il tuo saldo crediti e i webhook registrati.
  </Card>

  <Card title="Webhook" icon="bell" href="/it/how-webhooks-work">
    Ricevi i risultati automaticamente anziché tramite polling.
  </Card>

  <Card title="Limiti di frequenza" icon="gauge-high" href="/it/rate-limits">
    Comprendi i limiti delle richieste API prima di scalare.
  </Card>
</CardGroup>