Lancer la vérification
curl -X POST https://api.klemail.io/v1/verify/single \
-H "Authorization: Token YOUR-API-KEY-HERE" \
-H "Content-Type: application/json" \
--data '{"email":"[email protected]"}'
import requests
res = requests.post(
"https://api.klemail.io/v1/verify/single",
json={"email": "[email protected]"},
headers={"Authorization": "Token YOUR-API-KEY-HERE"}
)
{
"id": 1234
}
Contrairement à la vérification "realtime", ce endpoint ne retourne pas directement le résultat, mais retourne un identifiant unique qu'il vous faudra ensuite utiliser pour vérifier le résultat de la vérification.
Récupérer les résultats
Pour récupérer le résultat de cette vérification il faut donc effectuer un "pooling" toute les 5 à 10 secondes pour vérifier le résultat.
curl -X GET https://api.klemail.io/v1/verify/single/1234 \
-H "Authorization: Token YOUR-API-KEY-HERE
import requests
res = requests.get(
"https://api.klemail.io/v1/verify/single/1234",
headers={"Authorization": "Token YOUR-API-KEY-HERE"}
)
{
"id": 1234,
"state": "launched",
"email": "[email protected]",
"status": null,
"simple_status": null,
"generic_email": False,
"disposable_email": False,
"free_email": False,
"created_at": "2021-05-03T19:15:33.545840Z",
"modified_at": "2021-05-03T19:15:33.545840Z",
"started_at": "2021-05-03T19:13:15.176759Z",
"ended_at": null
}
{
"id": 1234,
"state": "ended",
"email": "[email protected]",
"status": "GOOD",
"simple_status": "Good",
"generic_email": False,
"disposable_email": False,
"free_email": False,
"created_at": "2021-05-03T19:15:33.545840Z",
"modified_at": "2021-05-03T19:15:33.545840Z",
"started_at": "2021-05-03T19:13:15.176759Z",
"ended_at": "2021-05-03T19:15:33.492947Z",
}
Le point important est de verifier la variable state. Lorsque le traitement sera terminé, celle-ci aura la valeur ended
Pour plus d'information sur les variables et simple_status, voir la terminologie