API di validazione email

GET

curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://emailvalidation.cleariflow.com/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://emailvalidation.cleariflow.com/v1"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://emailvalidation.cleariflow.com/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Avvio rapido

Per effettuare una richiesta, fornisci il tuo api_key univoco e l’email da verificare — non serve altro:

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = jane.doe@acme-corp.com

In caso di successo, la richiesta restituisce tutte le informazioni disponibili sull’indirizzo:

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Parametri della richiesta

string

obbligatorio

Le tue credenziali API personali. Le chiavi sono limitate per prodotto Cleariflow, quindi una chiave di validazione email non autorizza richieste ad altre API, ad esempio la geolocalizzazione IP.

String

obbligatorio

L’indirizzo email da verificare.

Boolean

Flag opzionale per disabilitare l’autocorrezione. Imposta auto_correct=false per disattivarla. È abilitata per impostazione predefinita.

Parametri della risposta

Le risposte vengono restituite in un JSON compatto e standardizzato.

String

Ripete l’email inviata nella richiesta.

String

Correzione suggerita quando viene rilevato un probabile errore di battitura (es. johnsmith@gmial.com => johnsmith@gmail.com). Vuoto se non c’è alcun suggerimento.

String

Valutazione di Cleariflow sulla capacità dell’indirizzo di ricevere posta. Valori possibili: DELIVERABLE, UNDELIVERABLE, UNKNOWN. DELIVERABLE richiede un controllo SMTP riuscito; se esistono record MX ma SMTP non può confermare la casella (comune con i grandi provider), il risultato è UNKNOWN. Tutti i piani eseguono gli stessi controlli; i gratuiti differiscono solo per quota mensile e limiti di frequenza (vedi codici 422 e 429).

Float

Punteggio decimale da 0 a 0.99 che riflette la qualità dell’indirizzo. Gli indirizzi disposable sono limitati a circa 0.05; senza conferma SMTP, massimo 0.55.

Boolean

true quando l’indirizzo corrisponde al pattern standard local@domain.tld. Elementi mancanti o caratteri non validi restituiscono false.

Boolean

true se il dominio appartiene a un provider di email gratuito (es. Gmail, Yahoo).

Boolean

true se il dominio è nella nostra lista di provider di caselle temporanee o usa e getta (es. Mailinator, Yopmail).

Boolean

true se la parte locale sembra un account di ruolo piuttosto che di un individuo, ad es. team@, sales@, info@.

Boolean

true se il dominio è configurato come catch-all.

Boolean

true quando esistono record MX per il dominio.

Boolean

true se la verifica SMTP ha esito positivo. Se SMTP fallisce ma altri controlli passano, il risultato può essere UNKNOWN. Sconsigliamo di bloccare registrazioni o invii di moduli basandosi solo su errori SMTP.

Esempi di richiesta

Esempio: probabile errore di battitura

Questo esempio mostra una richiesta in cui viene rilevato un probabile errore di battitura nell’indirizzo inviato. Anche quando viene trovato un probabile errore di battitura, tutti gli altri controlli (es. email gratuita, dominio usa e getta) vengono eseguiti sull’indirizzo originariamente inviato — non sulla correzione suggerita.

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith@gmial.con

Una risposta di successo ha questo aspetto:

{
  "email": "johnsmith@gmial.con",
  "autocorrect": "johnsmith@gmail.com",
  "deliverability": "UNKNOWN",
  "quality_score": 0.4,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

Esempio: formato non valido

Questo esempio mostra un indirizzo che non supera la formattazione di base. Quando is_valid_format è false, i controlli successivi (es. is_free_email, is_role_email) vengono saltati e segnalati come false.

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith

Una risposta di successo ha questo aspetto:

{
  "email": "johnsmith",
  "autocorrect": "",
  "deliverability": "UNDELIVERABLE",
  "quality_score": 0.0,
  "is_valid_format": {
    "value": false,
    "text": "FALSE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

Caricamento massivo (CSV)

Preferisci non chiamare l’API direttamente? Usa il caricamento massivo CSV — i risultati ti verranno inviati via email al termine dell’elaborazione. Durante il caricamento di un CSV, segui queste linee guida:

Inserisci gli indirizzi email nella prima colonna.
Elimina le righe vuote.
Usa un indirizzo per riga.
Limita i file a un massimo di 50.000 righe.

Codici di risposta ed errore

Gli errori vengono restituiti in JSON con un codice e una descrizione leggibile. I codici più comuni sono elencati di seguito.

Code	Type	Details
200	OK	Richiesta completata con successo.
400	Bad request	Richiesta malformata o non valida.
401	Unauthorized	Autenticazione fallita — di solito chiave API mancante o non valida.
422	Quota reached	Quota esaurita (es. crediti insufficienti sui piani gratuiti).
429	Too many requests	Limite di frequenza superato (i piani gratuiti consentono fino a 1 richiesta/secondo).
500	Internal server error	Errore imprevisto dal nostro lato.
503	Service unavailable	Servizio temporaneamente non disponibile.

Altre note

Nota sui piani: tutti i piani (gratuiti e a pagamento) eseguono gli stessi controlli, inclusi MX, SMTP e rilevamento catch-all. Nota sulla fatturazione: ogni email valutata consuma un credito per richiesta — indipendentemente dall’esito. L’invio di un indirizzo non valido (es. “fda3346ds”) conta comunque come un credito.

API di validazione email

curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://emailvalidation.cleariflow.com/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://emailvalidation.cleariflow.com/v1"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://emailvalidation.cleariflow.com/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Validazione

Lookup

Creazione

Avvio rapido

Parametri della richiesta

Parametri della risposta

Esempi di richiesta

Esempio: probabile errore di battitura

Esempio: formato non valido

Caricamento massivo (CSV)

Codici di risposta ed errore

Altre note

​Avvio rapido

​Parametri della richiesta

​Parametri della risposta

​Esempi di richiesta

​Esempio: probabile errore di battitura

​Esempio: formato non valido

​Caricamento massivo (CSV)

​Codici di risposta ed errore

​Altre note

Avvio rapido

Parametri della richiesta

Parametri della risposta

Esempi di richiesta

Esempio: probabile errore di battitura

Esempio: formato non valido

Caricamento massivo (CSV)

Codici di risposta ed errore

Altre note