Skip to content

Validation des destinataires ​

Avant de livrer un email, Mailiqo vérifie que le destinataire existe et est joignable. Cela protège votre réputation d'envoi : chaque bounce l'abîme, et une mauvaise réputation envoie vos emails en spam même quand ils sont légitimes.

Il y a deux niveaux de vérification :

Ce qu'elle faitCoût
BasiqueFormat, domaine, enregistrements MX et résultats déjà connusIncluse dans tous les plans
AvancéeVérifie aussi la boîte mail auprès du serveur de destinationUn crédit par nouvelle vérification ; réutiliser un résultat valide est gratuit

Si vous n'avez plus de crédits, l'envoi n'est pas bloqué : les destinataires restants sont vérifiés avec la validation basique.

D'où vient la configuration ​

La configuration vit sur chaque domaine d'envoi, et vous la définissez dans l'espace client, dans l'onglet Délivrabilité du domaine. Elle s'applique de la même façon à l'API, à SMTP et aux envois depuis l'espace client.

Ce qui est toujours vérifié

Le format de l'adresse, les enregistrements MX du domaine et le résultat des vérifications précédentes s'appliquent à chaque envoi, quelle que soit la configuration : ils protègent votre réputation et ne peuvent pas être désactivés. Ce que vous configurez ci-dessous est la profondeur de la vérification et la sévérité de la décision.

Elle a trois parties :

Vérification avancée — quand la boîte mail est sondée sur le serveur de destination. C'est la partie qui utilise un crédit de validation.

ValeurComportement
NEVERLa boîte mail n'est jamais sondée ; seule la vérification basique s'exécute
UNKNOWN_ONLYSeul ce qui n'est pas déjà vérifié et à jour est sondé
ALWAYSSondée à chaque envoi, sans réutiliser les vérifications précédentes

Seule une vérification avancée marque un destinataire comme connu : une vérification basique ne confirme pas la boîte mail, elle n'enregistre donc pas le sondage.

Sévérité — quels résultats sont acceptés pour poursuivre.

ValeurComportement
SOFT (préventive)Écarte les adresses invalides et tout résultat douteux que vous avez marqué à bloquer
STRICT (restrictive)Seuls les destinataires confirmés comme valides sont acceptés

Résultats bloqués — quels cas douteux vous voulez écarter quand le niveau est préventif. Par défaut, rien n'est bloqué : un résultat douteux est quand même envoyé. Cochez seulement ce que vous préférez écarter.

RésultatCe que cela signifie
catch_allLe domaine accepte n'importe quelle adresse, la boîte mail ne peut donc pas être confirmée
riskyL'adresse existe mais présente des signes de faible qualité ou de spam trap
unknownLe serveur de destination n'a pas répondu à temps

Tout ce qui est invalid est toujours écarté, quelle que soit la configuration.

Ajuster la validation pour un seul envoi ​

Si un envoi mérite plus d'attention que d'habitude — une confirmation de commande, une réinitialisation de mot de passe — vous pouvez l'ajuster dans la requête elle-même avec l'objet validation. Il est facultatif : sans lui, la configuration du domaine s'applique.

Où il s'utilise

L'objet validation et force_validation sont acceptés sur les deux endpoints d'envoi : POST /mailing/send et POST /mailing/send-template.

Il n'y a pas d'équivalent SMTP : les envois SMTP utilisent toujours la configuration du domaine. Et si ce que vous voulez est vérifier des adresses sans rien leur envoyer, c'est l' API de validation que vous cherchez.

json
{
  "from": "[email protected]",
  "to": "[email protected]",
  "subject": "Confirmez votre commande",
  "body_html": "<p>Merci pour votre achat.</p>",
  "validation": {
    "mode": "always",
    "level": "restrictive"
  }
}
ChampValeursDescription
modeunknown_only, alwaysQuand la boîte mail est sondée
levelpreventive, restrictiveNiveau d'exigence
blockliste parmi catch_all, risky, unknownRésultats douteux que vous écartez pour cet envoi

Correspondance avec la configuration du domaine ​

L'espace client et la requête nomment les mêmes choses de deux façons différentes. Ce tableau les relie :

Configuration du domaineValeur dans la requêteEffet
Vérification avancée NEVER(non disponible)Une requête ne peut que renforcer, jamais désactiver
Vérification avancée UNKNOWN_ONLYmode: "unknown_only"Sonde seulement ce qui n'est pas déjà vérifié
Vérification avancée ALWAYSmode: "always"Sonde à chaque envoi
Sévérité SOFT (préventive)level: "preventive"Écarte les adresses invalides et ce que vous mettez dans block
Sévérité STRICT (restrictive)level: "restrictive"N'accepte que les destinataires confirmés comme valides
Résultats bloquésblock: ["catch_all", "risky", "unknown"]Ajoutés à ce que le domaine bloque déjà

Les valeurs sont insensibles à la casse. Pour compatibilité, soft et strict sont aussi acceptés dans les deux champs, mais ils ne signifient pas la même chose dans chacun (mode: "strict" équivaut à always, tandis que level: "strict" équivaut à restrictive). Utilisez unknown_only/always et preventive/restrictive, qui sont sans ambiguïté.

Un envoi ne peut que renforcer

L'ajustement n'assouplit jamais la configuration du domaine. Si votre domaine sonde déjà à chaque envoi et que la requête demande unknown_only, il reste à always. Et block ne fait qu'ajouter : si votre domaine bloque déjà risky, un envoi ne peut pas lever ce blocage en l'omettant.

C'est pourquoi never n'est pas accepté depuis la requête : un envoi peut demander plus de vérification, jamais moins.

Une valeur non reconnue renvoie 400 avec le code 1419.

force_validation ​

force_validation: true lance une nouvelle vérification de chaque destinataire pendant l'envoi, au lieu de le résoudre avec un résultat antérieur. C'est le raccourci de validation.mode: "always", il consomme donc un crédit par destinataire vérifié.

Il ne change pas le niveau d'exigence de la vérification : forcer une vérification n'assouplit jamais la politique d'envoi. Et s'il ne vous reste plus de crédits, l'envoi n'est pas bloqué : la vérification sera basique, et le résultat l'indique avec advanced: false.

Une relivraison technique du même envoi ne vérifie ni ne facture de nouveau : le résultat déjà stocké par cette opération est récupéré.

Lire le résultat ​

La validation avancée a lieu pendant l'envoi, après que l'API vous a déjà répondu. C'est pourquoi la réponse de POST /send ne porte aucun résultat par destinataire : quand vous la recevez, la vérification n'a pas encore eu lieu.

Ce que la réponse renvoie bien, ce sont les destinataires écartés avant la mise en file, dans rejected_recipients, avec leur motif : mauvais format, ou un résultat précédent que votre configuration n'accepte pas.

Le résultat complet vit dans le détail de chaque destinataire :

GET /v1/mailing/email-message/{uuid}
json
{
  "status": "success",
  "data": {
    "uuid": "9f1c...",
    "recipient_email": "[email protected]",
    "status": "rejected",
    "validation": {
      "checked": true,
      "pending": false,
      "advanced": true,
      "reused": false,
      "classification": "catch_all",
      "reason": "Mailbox not verifiable",
      "reason_code": "mailbox_not_verifiable",
      "checked_at": "2026-01-01T10:29:07+00:00"
    }
  }
}
ChampDescription
checkedUn résultat de validation est déjà disponible
pendingIl a été marqué pour vérification et l'envoi ne l'a pas encore validé
advancedLa vérification a sondé la boîte mail. Elle décrit la portée technique, pas la facturation
reusedLe résultat a réutilisé une de vos vérifications encore valide, sans consommer de crédit
classificationvalid, catch_all, risky, unknown ou invalid. null si pas encore vérifié
reasonMotif lisible renvoyé par le validateur. null si pas encore vérifié
reason_codeCode stable du motif. null si pas encore vérifié
checked_atDate de la vérification, pas de l'envoi : réutiliser un résultat antérieur ne la renouvelle pas

L'objet validation est toujours présent. Quand il n'y a pas encore de résultat, checked vaut false et les champs de résultat reviennent à null.

Quand la validation écarte un destinataire, son status devient rejected et le motif apparaît aussi dans error_message.

Vous obtenez l'UUID de chaque destinataire dans email_messages en appelant GET /email-request/{uuid}. Interrogez chacun avec GET /email-message/{uuid} pour lire son bloc validation : s'il est encore pending, ce qui a été checked, et si la vérification était advanced.

Crédits de validation ​

Vous êtes facturé pour l'exécution d'une nouvelle vérification avancée, quel que soit le canal : API d'envoi, SMTP, API de validation ou espace client. Consulter ou réutiliser une de vos vérifications encore valide ne consomme aucun crédit supplémentaire, et la vérification basique n'en consomme jamais.

Une vérification exécutée est facturée même si elle conclut que l'adresse est invalide ou laisse le résultat en unknown : ce que vous payez est la vérification, pas le verdict. Si une défaillance interne l'empêche d'aboutir, le crédit est restitué.

Les crédits viennent de deux sources :

  • Inclus dans votre plan : ils se renouvellent chaque mois et expirent à la clôture du cycle.
  • Achetés en packs : ils expirent 12 mois après l'achat.

Ceux qui expirent le plus tôt sont toujours utilisés en premier, les crédits du plan sont donc dépensés avant les crédits achetés. Vous pouvez consulter votre solde et acheter des packs depuis l'espace client, et activer la recharge automatique pour qu'un pack soit acheté quand le solde passe sous le minimum que vous fixez.

Si vous demandez une validation avancée sur un envoi et que vous n'avez plus de crédits, l'envoi n'est pas bloqué : la vérification redescend en basique et le résultat le signale avec validation.advanced à false. Sur l'API de validation, l'absence de crédits rejette bien la requête.

Built with VitePress