qualification che comunica il risultato di una ricerca o di una verifica. Questa pagina elenca tutti i codici e i valori di qualificazione, così da poter gestire le risposte in modo affidabile. Per i messaggi di errore corrispondenti e i formati delle risposte, consulta Gestione degli errori.
Quali codici di stato HTTP restituisce l’API?
L’API Enrow utilizza i codici di stato HTTP standard per indicare il risultato di ogni richiesta. Un codice2xx significa che la richiesta è andata a buon fine, un codice 4xx segnala un problema con la richiesta e un codice 5xx significa che qualcosa è andato storto sul lato di Enrow.
Quali codici indicano un successo?
Un codice di stato2xx significa che l’API ha accettato la richiesta. Le operazioni asincrone (come le ricerche in blocco) restituiscono 201 o 202 perché l’elaborazione prosegue in background.
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Richiesta riuscita, risultati restituiti |
| 201 | Created | Risorsa creata (es. ricerca in blocco avviata) |
| 202 | Accepted | Richiesta accettata, elaborazione asincrona |
Quali codici indicano che la richiesta è stata rifiutata?
Un codice di stato4xx significa che l’API ha rifiutato la richiesta a causa di un problema risolvibile sul lato client: parametri non validi, una chiave API mancante o non valida, crediti insufficienti o troppe richieste.
| Code | Meaning | Description |
|---|---|---|
| 400 | Bad Request | Parametri non validi o mancanti |
| 401 | Unauthorized | Chiave API non valida o mancante |
| 402 | Payment Required | Crediti insufficienti |
| 429 | Too Many Requests | Limite di frequenza superato |
401 significa che la chiave API è mancante o non valida: consulta Autenticazione per scoprire come passarla correttamente. Un 402 significa che l’account ha esaurito i crediti; verifica il consumo in Crediti e fatturazione. Un 429 significa che la richiesta ha superato il throughput consentito: consulta Limiti di frequenza per comprendere le soglie.
L’API non restituisce mai 404. Un ID di ricerca sconosciuto o scaduto restituisce 400 per gli endpoint in blocco e 500 per gli endpoint singoli.
Quali codici indicano un errore del server?
Un codice di stato5xx significa che la richiesta era valida ma qualcosa è andato storto sul lato di Enrow. Queste risposte possono essere ritentate in sicurezza dopo una breve attesa.
| Code | Meaning | Description |
|---|---|---|
| 500 | Internal Server Error | Qualcosa è andato storto dalla nostra parte |
Cosa sono le qualificazioni delle ricerche?
Una qualificazione di ricerca è il valore presente nel campoqualification che comunica l’esito di una ricerca o di una verifica. Enrow restituisce questo campo su tutti gli endpoint e il risultato è sempre binario: non esiste un “forse” né un punteggio di probabilità. Si tratta di una scelta progettuale deliberata.
Perché il risultato è binario?
Il risultato è binario perché una risposta chiara, sì o no, è più facile da gestire rispetto a una probabilità. La maggior parte degli strumenti di arricchimento restituisce un insieme complesso di categorie — catch-all, rischioso, sconosciuto, non verificabile, ecc. — che ti costringe a costruire logica attorno alle probabilità. Enrow ha adottato l’approccio opposto:- Enrow verifica in modo deterministico anche le email catch-all, quindi non serve una categoria “catch-all”
- Enrow non crede nei sistemi probabilistici con decine di classificazioni: aggiungono complessità senza chiarezza
- Un risultato binario significa che puoi agire sui dati immediatamente senza ripensamenti
Quali qualificazioni restituisce Email Finder?
L’Email Finder restituisce uno dei seguenti valori nel campoqualification:
| Qualification | Meaning |
|---|---|
valid | Email trovata e verificata |
invalid | Email non trovata |
ongoing | Ricerca ancora in corso |
Quali qualificazioni restituisce Email Verifier?
L’Email Verifier restituisce uno dei seguenti valori nel campoqualification:
| Qualification | Meaning |
|---|---|
valid | Email valida e recapitabile |
invalid | Email non valida o non recapitabile |
ongoing | Verifica ancora in corso |
invalid ha significati diversi a seconda dell’endpoint: nell’Email Finder significa che l’email non è stata trovata. Nell’Email Verifier significa che l’email esiste ma non è recapitabile.Quali qualificazioni restituisce Phone Finder?
Il Phone Finder restituisce uno dei seguenti valori nel campoqualification:
| Qualification | Meaning |
|---|---|
found | Numero di telefono individuato con successo |
not_found | Impossibile trovare il numero di telefono |
ongoing | Ricerca ancora in corso |
Come monitoro una ricerca in blocco?
Per le operazioni in blocco, un campostatus indica l’avanzamento del lotto. Interroga l’endpoint GET pertinente — risultati in blocco di Email Finder, verifiche in blocco di Email Verifier o risultati in blocco di Phone Finder — finché lo status non è completed.
| Status | Meaning |
|---|---|
ongoing | Il lotto è ancora in elaborazione |
completed | Tutte le ricerche del lotto sono terminate |
failed | Il lotto è fallito |
FAQ
Perché ricevo un 401 invece di un 200?
Perché ricevo un 401 invece di un 200?
Un
401 Unauthorized significa che la chiave API è mancante o non valida. Assicurati che ogni richiesta includa una chiave valida nell’header x-api-key. Per i dettagli, consulta Autenticazione.Cosa significa un codice di stato 402?
Cosa significa un codice di stato 402?
Un
402 Payment Required significa che l’account non dispone di crediti sufficienti per completare la richiesta. Ricarica oppure verifica come vengono consumati i crediti per ogni endpoint in Crediti e fatturazione.Perché un ID di ricerca sconosciuto restituisce 400 o 500 invece di 404?
Perché un ID di ricerca sconosciuto restituisce 400 o 500 invece di 404?
L’API Enrow non restituisce mai
404. Un ID di ricerca sconosciuto o scaduto restituisce 400 per gli endpoint in blocco e 500 per gli endpoint singoli. Ricontrolla l’id restituito al momento dell’avvio della ricerca.qualification: ongoing significa che qualcosa è fallito?
qualification: ongoing significa che qualcosa è fallito?
No.
ongoing significa che la ricerca o la verifica è ancora in corso. Interroga di nuovo l’endpoint GET dopo una breve attesa, oppure usa un webhook per ricevere una notifica automatica al termine: consulta Come funzionano i webhook.Prossimi passi
Gestione degli errori
Consulta tutti i messaggi di errore e i formati delle risposte per ogni codice di stato.
Autenticazione
Passa la tua chiave API nell’header x-api-key per evitare errori 401.
Limiti di frequenza
Comprendi le soglie che attivano una risposta 429.
Crediti e fatturazione
Scopri come vengono consumati i crediti ed evita gli errori 402.