Format du fichier CSV#
Séparateur#
L’outil détecte automatiquement le séparateur : ; (français) ou , (international). L’encodage UTF-8 est recommandé (le BOM Excel est géré automatiquement).
Colonnes attendues#
Seules les colonnes que vous mappez sont validées. Les autres colonnes sont conservées telles quelles dans le fichier résultat.
| Mapping | Type de validation | Crédits |
|---|---|---|
| Syntaxe + DNS + boîte + jetable + rôle + fournisseur | 1 / ligne | |
| Téléphone | Normalisation +33 + format | 1 / ligne |
| Les deux | Email + téléphone | 2 / ligne |
Limites#
| Via | Limite de lignes | Taille max |
|---|---|---|
| Dashboard (JWT) | 2 000 lignes | 5 Mo |
| API (X-API-Key) | Illimitée | 5 Mo |
Interprétation des résultats#
Verdict global (verdict)#
| Verdict | Signification | Action recommandée |
|---|---|---|
| ✓ Valide | Adresse confirmée, boîte existante | Conserver |
| ⚠ À vérifier | Incertitude (serveur ne répond pas clairement) | Conserver mais surveiller les bounces |
| ✗ Invalide | Syntaxe incorrecte, domaine inexistant ou boîte rejetée | Supprimer de votre liste |
Détail des checks email#
| Check | Ce qu’il vérifie |
|---|---|
syntaxe_ok | Format RFC 5322 respecté |
boite_existe | Le serveur mail confirme l’existence de la boîte |
email_jetable | Domaine connu comme temporaire (Guerrilla Mail, Mailinator, etc.) |
fournisseur_gratuit | Gmail, Outlook, Yahoo, ProtonMail, etc. |
adresse_generique | Adresse de type rôle : info@, contact@, support@, etc. |
Fichier XLSX#
Le fichier Excel contient la même donnée que le CSV, avec en plus :
- Mise en forme couleur automatique (vert = valide, orange = à vérifier, rouge = invalide)
- En-têtes en gras
- Colonnes auto-dimensionnées
Utilisation via l’API#
L’API permet d’automatiser la validation sans passer par le dashboard. Disponible après achat d’au moins un pack de crédits.
Créer une clé API#
- Dans le dashboard, section Clés API
- Cliquez Créer une clé
- Copiez la clé (non récupérable après fermeture)
Limite : 2 clés actives par utilisateur.
Workflow API#
# 1. Obtenir une URL d'upload pré-signée
curl -X POST https://api.yannick.services/validation/upload-url \
-H "X-API-Key: votre_clé" \
-H "Content-Type: application/json" \
-d '{"filename": "contacts.csv", "contentType": "text/csv"}'
# 2. Uploader le fichier sur l'URL retournée
curl -X PUT "URL_PRESIGNEE_RETOURNEE" \
-H "Content-Type: text/csv" \
--data-binary @contacts.csv
# 3. Lancer la validation
curl -X POST https://api.yannick.services/validation/start \
-H "X-API-Key: votre_clé" \
-H "Content-Type: application/json" \
-d '{"jobId": "ID_RETOURNE_ETAPE_1", "columnMapping": {"email": "email", "phone": "telephone"}}'
# 4. Vérifier le statut
curl https://api.yannick.services/validation/jobs \
-H "X-API-Key: votre_clé"
# 5. Télécharger les résultats (quand statut = completed)
curl https://api.yannick.services/validation/jobs/JOB_ID/download \
-H "X-API-Key: votre_clé"Endpoints API#
| Route | Méthode | Description |
|---|---|---|
/validation/credits | GET | Solde de crédits |
/validation/upload-url | POST | URL pré-signée pour l’upload |
/validation/start | POST | Lancer un job de validation |
/validation/jobs | GET | Historique des jobs (paginé) |
/validation/jobs/{id}/download | GET | URLs de téléchargement (CSV + XLSX) |
/validation/api-keys | POST/GET/DELETE | Gestion des clés API |
Crédits — Fonctionnement#
- Les crédits sont débités uniquement pour les lignes traitées avec succès
- Les lignes vides, en erreur de parsing, ou sans donnée dans la colonne mappée ne consomment pas de crédits
- Le débit est atomique : il a lieu à la fin du job, pas ligne par ligne
- Si votre solde est insuffisant pour couvrir toutes les lignes, le job ne démarre pas
Vous pouvez consulter votre solde à tout moment via
GET /validation/credits ou dans le dashboard.
