Validation d'une base email par lots
Pour le nettoyage d'une liste, le traitement par lots analyse un fichier d'adresses de façon asynchrone, puis le restitue ligne par ligne enrichi de son statut. Il applique exactement les mêmes contrôles et les mêmes règles de facturation que la validation en temps réel. Un mode audit permet de mesurer la qualité d'une liste sans dépenser un crédit.
Ce qu'un fichier peut contenir
Un fichier importé peut compter jusqu'à cinq cent mille lignes, pour quinze mégaoctets au plus. Les formats acceptés à l'import sont le CSV et le texte brut. Le format tableur est un format de sortie, pas un format d'entrée : il n'est proposé qu'au moment de récupérer le résultat du traitement.
| Contrainte | Valeur |
|---|---|
| Lignes traitées au maximum | 500 000 lignes |
| Taille du fichier importé | 15 mégaoctets |
| Formats acceptés à l'import | CSV, TXT |
| Formats disponibles à l'export | CSV, XLSX, PDF |
| Appel | Rôle |
|---|---|
| POST /v2/batch/upload | Déposer un fichier d'adresses et créer un traitement par lots. |
| GET /v2/batch/:jobId/status | Suivre l'avancement d'un traitement par lots. |
Le déroulement d'un traitement
Un traitement se déroule en cinq étapes. Le fichier est d'abord analysé sans rien consommer, puis les contrôles gratuits s'exécutent sur chaque ligne. Viennent ensuite deux passes de vérification SMTP, la seconde rattrapant les serveurs qui ont temporisé. Le fichier est enfin restitué, et les adresses indéterminées sont remboursées.
| Étape | Ce qui s'y passe |
|---|---|
| Dépôt et aperçu | Le fichier est analysé avant traitement : colonnes détectées, doublons, lignes illisibles. Rien n'est encore consommé. |
| Contrôles sans crédit | Les dix-huit contrôles gratuits s'exécutent sur chaque ligne : syntaxe, DNS, domaines jetables, typosquatting, comptes de rôle, santé du domaine. |
| Première passe SMTP | Les adresses éligibles sont sondées. Le rythme s'adapte à chaque serveur destinataire et à chaque adresse IP émettrice. |
| Seconde passe SMTP | Les adresses restées indéterminées après la première passe sont resondées plus tard, ce qui rattrape les temporisations. |
| Restitution | Le fichier est restitué ligne par ligne, et le débit prédictif des adresses restées indéterminées est remboursé à la clôture. |
- Dépôt et aperçu terminé
- Contrôles sans crédit terminé
- Première passe SMTP en cours
- Seconde passe SMTP en attente
- Restitution en attente
Verdicts rendus, ligne par ligne
- valid
- invalid
- risky
- unknown
Le rythme des sondes SMTP s'adapte à chaque serveur destinataire. Un fournisseur qui ralentit ou refuse les sondes fait baisser la cadence de lui-même, plutôt que de faire échouer le traitement.
Mesurer une liste avant de la traiter
Le mode audit répond à une question précise : que vaut ce fichier, et combien coûterait son traitement complet ? Il mesure exactement ce qui se mesure sans sonde, estime la délivrabilité sur un échantillon sondé gratuitement, et ne débite aucun crédit. C'est le mode qui permet de décider avant de dépenser.
Ce que l'audit donne
Le mode audit produit un rapport de qualité sur un fichier entier sans débiter le moindre crédit. Il mesure exactement ce qui se mesure sans sonde, estime la délivrabilité à partir d'un échantillon sondé gratuitement, et chiffre ce que coûterait le traitement complet avant qu'il ne soit lancé.
Ce que l'audit ne donne pas
L'audit ne restitue pas le détail ligne par ligne : c'est le traitement complet qui le fait.
L'audit exécute bien des vérifications SMTP, sur un échantillon seulement, et elles ne sont pas facturées. L'échantillon est tiré par fournisseur, proportionnellement au poids réel de chacun dans le fichier, ce qui évite qu'un gros domaine écrase la mesure ou qu'une longue traîne la fasse dévier.
Ce qui est facturé, et ce qui ne l'est pas
La règle du traitement par lots est celle du temps réel, appliquée ligne à ligne. Un crédit est débité pour chaque adresse dont la vérification SMTP a permis de conclure. Les adresses restées indéterminées sont débitées par prévision au lancement, puis remboursées à la clôture du traitement.
Un crédit est débité si et seulement si la vérification SMTP a été demandée et que le statut final n'est pas « unknown ».
| Cas | Ce que fait le moteur |
|---|---|
| La vérification SMTP n'a pas été demandée | L'appel porte « smtp: false ». Les dix-huit autres contrôles s'exécutent sans quota. |
| L'adresse figure en liste blanche de l'organisation | Le SMTP est court-circuité, la liste tranche. |
| L'adresse figure en liste noire de l'organisation | Le SMTP est court-circuité, la liste tranche. |
| Le statut final est « unknown » | En temps réel, aucun débit n'a lieu. En traitement par lots, le débit prédictif est remboursé à la finalisation du job. |
| Le fichier est traité en mode audit | Le mode audit n'exécute aucun SMTP et ne débite aucun crédit. |
Les 18 contrôles gratuits s'appliquent à toutes les lignes du fichier, sans quota. Un domaine jetable ne fait pas exception : il est sondé comme un autre, et facturé si le statut final permet de conclure.
Questions fréquentes
- Combien coûte le traitement d'un fichier ?
- Un crédit par adresse pour laquelle la vérification SMTP a permis de conclure. Les adresses restées indéterminées ne sont pas facturées : leur débit prédictif est remboursé à la clôture du traitement. Les dix-huit contrôles gratuits s'appliquent à toutes les lignes, sans quota.
- Peut-on connaître la qualité d'une liste avant de payer ?
- Oui, c'est le rôle du mode audit. Il compte exactement ce qui se mesure sans sonde sur la liste entière, estime la délivrabilité à partir d'un échantillon sondé gratuitement, et ne débite aucun crédit. Il indique aussi combien de vérifications SMTP le traitement complet demanderait réellement.
- Pourquoi deux passes SMTP au lieu d'une ?
- Parce qu'un serveur destinataire qui applique une temporisation refuse la première sonde et accepte la seconde. Resonder plus tard les adresses restées indéterminées après la première passe rattrape ces cas, et diminue le nombre d'adresses sur lesquelles le traitement ne conclut pas.
- Quels formats de fichier sont acceptés ?
- À l'import, les formats CSV et TXT. Le format XLSX n'est pas accepté à l'import : c'est un format de sortie. À l'export, le résultat est disponible en CSV, en XLSX et en PDF.
Aller plus loin
La page de référence de l'API rassemble les paramètres, les codes de réponse et le détail des contrôles appliqués à chaque ligne. Pour valider une adresse au moment de la saisie plutôt qu'en masse, la validation en temps réel utilise le même moteur et les mêmes règles de facturation.