Vérification unitaire

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":"contact@klemail.io"}'

import requests

res = requests.post(
  "https://api.klemail.io/v1/verify/single",
  json={"email": "contact@klemail.io"},
  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": "aymeric@klemail.io",
  "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": "aymeric@klemail.io",
  "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