API

Avec l'API de CaptainVerify, vous pouvez intégrer la vérification d'email dans vos propres applications. Nous conseillons d'utiliser l'API a posteriori car une vérification peut être plus ou moins longue (1 voire 2 minutes) donc il vaut mieux éviter de le brancher sur votre formulaire directement car vous risquez de perdre des prospects.

Clé API

Un compte est nécessaire pour générer la clé pour l'API, c'est ce qui vous donnera accès au service.

La requête

Pour faire une demande à l'API, appelez simplement le protocole GET à cette URL:

https://api.captainverify.com/verify?email=john.doe@gmail.com&apikey=XXXXXXXXXXXXXXXXXXXX

Remplacez john.doe@gmail.com par votre email pour vérifier

Limites de l'API

L'API est limitée à un maximum de 2 connexions simultanées et 50 vérifications par minute. Lorsque vous intégrez l'API, assurez-vous que votre application ne dépasse pas cette limite.

La réponse

Une table json sera renvoyée avec ces variables:

Variables Valeur possible

success

true, false
Si l'authentification a échoué, l'épuisement de vos crédits

message

default : null
Lorsque le succès est faux, un message d'erreur sera envoyé.

credits

Crédits disponibles sur votre compte

email

L'email que vous souhaitez vérifier

email_normalized

L'email a normalisé, l'élimination des étiquettes pour gmail ... support+test@gmail.com sera support@gmail.com

role

true, false
Si l'utilisateur du courrier électronique a un rôle, ex: support@exemple.com

free

true, false
Si le fournisseur de messagerie est gratuit, ex : Gmail.com

disposable

true, false
L'email est valide, mais jetable après une courte période il ne sera plus possible de contacter l'utilisateur.

risky

true, false
Si le fournisseur de courrier électronique lutte contre le spam et n'est pas un utilisateur réel

did_you_mean

default : null
Si par exemple, le courrier électronique est john.doe@gmil.com, l'API vous enverra une proposition comme john.doe@gmail.com

result

valid, invalid, unknown
Le statut de l'email. si tous vos crédits ont été épuisés, le statut inconnu sera toujours retourné, pour ne pas bloquer votre application.

details

null, error, smtp_error, antispam_system, email_disable, ok_for_all...
Comprendre pourquoi une vérification est inconnue.

Pour vérifier la validité de vos données avec notre API.
Inscrivez-vous dès maintenant