Installer le widget de vérification d'e-mails

Créer un compte gratuitOffres et crédits

Ce que fait le widget

Le widget vérifie l'adresse saisie dans un formulaire avant l'envoi et affiche un message (« This email is ok » / « This email is invalid », textes modifiables). Il fonctionne dans le navigateur du visiteur avec une clé de widget qui ne marche que sur le domaine autorisé pour elle ; elle peut donc être visible dans la page. Chaque vérification utilise un crédit du compte.

Limites qui protègent vos crédits :

• chaque IP de visiteur peut faire 20 vérifications par jour et par domaine ; ensuite le widget affiche « You performed many validations » ;
• une clé de widget ne fonctionne que depuis son domaine autorisé (et localhost pour les tests) et elle est refusée par l'API REST et les endpoints de vérification en masse.

Pour vérifier côté serveur (inscriptions, imports), utilisez l'API REST avec une clé API normale : https://www.easyemailverification.com/en-US/api

Étape 1 : créez une clé de widget

1. Il vous faut un compte Easy Email Verification : https://dashboard.easyemailverification.com/register?utm_source=widget_guide (l'offre gratuite inclut 50 vérifications par jour).
2. Dans le tableau de bord, ouvrez Integration → Form Integration et cliquez sur Create a new Form integration.
3. Saisissez un Origin name (n'importe quel libellé) et l'Authorized domain : le domaine du site qui contient le formulaire, par exemple example.com.
4. Copiez la clé de widget dans la liste.

Étape 2 : ajoutez le script au site

Collez ceci juste avant la balise de fermeture </body> de chaque page contenant le formulaire, avec votre clé de widget et votre domaine autorisé :

<script type="text/javascript" src="https://dashboard.easyemailverification.com/form-assets/easy_v1.1.min.js"></script>
<script type="text/javascript">
  easyObj = {
    api_key: '<your widget key>',
    domain_name: '<your authorized domain>',
    valid_message: "Cette adresse est valide",
    invalid_message: "Cette adresse n'est pas valide"
  };
  EasyApi.init();
</script>

La clé de widget est faite pour être dans la page (elle ne fonctionne que sur le domaine autorisé). Ne mettez jamais une clé API normale dans du code exécuté par le navigateur.

Étape 3 : assurez-vous que le champ e-mail est détecté

Par défaut, le widget surveille les champs type="email" ou name="email" (ou id="email"). Si le formulaire utilise d'autres noms, définissez les sélecteurs dans easyObj :

easyObj = {
  api_key: '<your widget key>',
  domain_name: '<your authorized domain>',
  email_field: "input[type='emailx'], input[name='emailx']",
  button_id: "button[type='submit'], input[type='submit']",
  valid_message: "Cette adresse est valide",
  invalid_message: "Cette adresse n'est pas valide"
};

Étape 4 : testez

Ouvrez la page sur le domaine autorisé (ou sur localhost), saisissez une adresse que vous connaissez et quittez le champ : le message apparaît dessous. Saisissez ensuite une adresse invalide, comme john@gmial-invalid-domain.com.

En cas de problème

1. « Origin is different from the authorized » : la page n'est pas sur le domaine autorisé ; corrigez le domaine dans Form Integration (ou testez sur localhost).
2. Rien ne se passe : le script doit se trouver après le formulaire dans la page, et le champ doit avoir type="email", name="email" ou correspondre au sélecteur email_field.
3. « You performed many validations » : la limite de 20 par jour pour cette IP de visiteur est atteinte.
4. « Running out of your credit limit » : consultez les offres sur https://www.easyemailverification.com/fr-FR/pricing

Toujours bloqué ? Écrivez à support@easyemailverification.com.