Vai al contenuto principale
Enrow utilizza un sistema basato su crediti e i crediti vengono consumati solo quando viene trovato un risultato o viene eseguito un controllo. Questa pagina spiega come vengono addebitati i crediti per ogni endpoint, come controllare il tuo saldo, come gestire le impostazioni di fatturazione e cosa succede quando i crediti si esauriscono.

​
Come funzionano i crediti?

I crediti vengono consumati solo quando l’API restituisce un risultato o completa un controllo: le ricerche fallite che non trovano nulla non costano crediti. Ogni funzionalità consuma crediti a una tariffa diversa:
EndpointCrediti
Email Finder1 per email trovata
Phone Finder40 per telefono trovato (predefinito; 50 con i piani legacy)
Email Verifier0,25 per controllo
I crediti vengono addebitati allo stesso modo per le operazioni singole e in blocco: per singolo risultato. Eseguire una ricerca email in blocco di 1.000 nomi costa, per email trovata, quanto 1.000 ricerche singole.
Ogni richiesta che consuma crediti restituisce un campo credits_used nella sua risposta, così puoi monitorare il consumo per ogni ricerca. Vedi Trova email per un esempio di risposta.

​
Come controllo il mio saldo di crediti?

Interroga l’endpoint dell’account con la tua chiave API nell’header x-api-key per recuperare il tuo saldo di crediti attuale. Non è necessario alcun payload nel corpo: l’account viene identificato dalla chiave API. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
La risposta contiene il tuo saldo e i webhook registrati:
CampoDescrizione
creditsIl tuo saldo di crediti attuale
webhooksArray degli URL dei tuoi webhook registrati
Per il riferimento completo dell’endpoint, vedi Informazioni account. Puoi anche visitare la tua Dashboard per visualizzare i dettagli di utilizzo e fatturazione, oppure consultare la guida Autenticazione per scoprire come funziona l’header x-api-key su ogni endpoint.

​
Come gestisco le impostazioni di fatturazione?

Dalla pagina di fatturazione nell’app, puoi configurare tre opzioni che mantengono il tuo account rifornito e ti avvisano prima che i crediti si esauriscano:
Rinnova automaticamente il tuo piano alla scadenza. Imposta la quantità di crediti da rinnovare nel campo di input accanto all’interruttore.
Acquista automaticamente crediti pay-as-you-go aggiuntivi quando il tuo saldo è basso. Imposta la quantità di crediti da ricaricare nel campo di input accanto all’interruttore.
Ricevi un avviso via email quando il saldo dei tuoi crediti scende al di sotto di una soglia. Imposta la soglia di crediti nel campo di input accanto all’interruttore.

​
Cosa succede quando i crediti si esauriscono?

Quando il saldo dei tuoi crediti raggiunge lo zero, le richieste API restituiscono uno stato HTTP 402. Gli endpoint singoli (trova email/telefono singolo, verifica singola) restituiscono: 
{
  "reason": "Insufficient credits",
  "success": false
}
Gli endpoint in blocco restituiscono invece { "message": "..." }. Per l’elenco completo dei codici di stato e delle forme delle risposte, vedi Codici di stato e Gestione degli errori.
Per evitare interruzioni, abilita la Ricarica automatica o l’Avviso saldo basso dalla pagina di fatturazione.

​
Quale piano dovrei scegliere?

Visita enrow.io/pricing per confrontare i piani e trovare quello più adatto alle tue esigenze. I crediti pay-as-you-go possono essere aggiunti a qualsiasi piano tramite la Ricarica automatica.

​
FAQ

No. I crediti vengono consumati solo quando viene trovata un’email o un numero di telefono, oppure quando viene eseguito un controllo di verifica. Una ricerca che non restituisce alcun risultato non costa crediti.
No. I crediti vengono addebitati per singolo risultato, quindi un’operazione in blocco costa, per email, telefono o verifica trovata, quanto le richieste singole equivalenti. Gli endpoint in blocco fanno risparmiare sulle richieste, non sui crediti.
L’Email Verifier consuma 0,25 crediti per controllo. L’Email Finder consuma 1 credito per email trovata e il Phone Finder consuma 40 crediti per telefono trovato (50 con i piani legacy).
Le richieste restituiscono uno stato HTTP 402. Gli endpoint singoli restituiscono { "reason": "Insufficient credits", "success": false }, mentre gli endpoint in blocco restituiscono { "message": "..." }. Vedi Gestione degli errori per i dettagli.

​
Passaggi successivi

Autenticazione

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

Informazioni account

Recupera il tuo saldo di crediti e i webhook registrati.

Limiti di frequenza

Comprendi i limiti delle richieste API prima di scalare.

Gestione degli errori

Gestisci con eleganza il 402 e le altre risposte di errore.