Vai al contenuto principale
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.

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 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 nell’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"]
}
Il valore credits è il tuo saldo rimanente, mentre webhooks elenca gli URL registrati sul tuo account. Consulta il riferimento Informazioni account 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, 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.
Invece di effettuare molte richieste singole, raggruppale (fino a 5.000 voci per richiesta bulk di email, 3.000 per richiesta bulk di telefoni):
// ❌ 100 separate requests
for (const contact of contacts) {
  await findEmail(contact);
}

// ✅ 1 bulk request
await findEmailsBulk(contacts);
Consulta Trova email e Trova telefoni per le operazioni in batch.
Il polling spreca crediti e quota dei limiti di frequenza. Usa i webhook per ricevere automaticamente i risultati:
{
  "fullname": "John Doe",
  "company_domain": "example.com",
  "settings": {
    "webhook": "https://your-app.com/webhook"
  }
}
Scopri come funziona la consegna in Come funzionano i webhook.
Memorizza i risultati per evitare chiamate API ridondanti per lo stesso contatto.

FAQ

No. Interrogare l’endpoint Informazioni account restituisce i tuoi crediti rimanenti e i webhook registrati senza consumare alcun credito.
I crediti vengono consumati secondo le regole descritte in Crediti e fatturazione. Quando una richiesta fallisce prima dell’elaborazione — ad esempio una risposta 402 Insufficient credits — non viene detratto alcun credito. Consulta Gestione degli errori e Codici di stato per i formati delle risposte.
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 per gli attuali limiti delle richieste.

Prossimi passi

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.

Informazioni account

Recupera il tuo saldo crediti e i webhook registrati.

Webhook

Ricevi i risultati automaticamente anziché tramite polling.

Limiti di frequenza

Comprendi i limiti delle richieste API prima di scalare.