API pour la vérification des e-mails

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.