POST /v1/validation/file
Met en file pour validation les adresses contenues dans un fichier. Envoyé en multipart/form-data avec un seul champ file.
C'est asynchrone : la réponse ne contient aucun résultat, seulement un uuid que vous utilisez pour les lire ensuite. Si vous avez déjà les adresses dans un tableau, utilisez plutôt POST /v1/validation/bulk.
Chaque adresse vérifiée utilise un crédit de validation.
Endpoint
POST /v1/validation/filecurl -X POST https://api.mailiqo.com/v1/validation/file \
-H "X-API-KEY: YOUR_API_KEY" \
-F "[email protected]"Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
file | file | Oui | Un seul fichier avec les adresses à valider. |
Extensions acceptées : .csv, .xlsx, .txt et .json. Un seul fichier par requête est autorisé ; en envoyer plusieurs est rejeté avec 1312.
Comment le fichier est lu
Chaque adresse candidate du fichier est validée et utilise un crédit, même si elle n'a pas la forme d'un email : dans ce cas, elle est classée invalid. Tout ce qui n'est pas un candidat n'est ni validé ni facturé. Les adresses répétées comptent à chaque apparition.
| Extension | Ce qui compte comme candidat |
|---|---|
.txt | Chaque ligne non vide est un candidat. Les lignes ne sont pas découpées sur les virgules, points-virgules ou espaces : [email protected], [email protected] sur la même ligne est un seul candidat, qui s'avère invalide. |
.csv | Le délimiteur (,, ; ou tabulation) est détecté automatiquement. Une colonne contient des emails quand plus de la moitié de ses cellules non vides contiennent @, et chaque cellule non vide de ces colonnes est un candidat. La première ligne est ignorée si elle n'a pas de @ (en-tête). Les autres colonnes (nom, téléphone…) sont ignorées. |
.xlsx | La même règle que .csv, feuille par feuille. |
.json | Toute la structure est parcourue et chaque valeur texte contenant @ est un candidat. Si le JSON ne peut pas être analysé, il est lu comme un .txt. |
TIP
Mettez une adresse par ligne, ou par cellule dans une seule colonne, pour que le compte corresponde exactement à vos adresses.
Réponse
Code 200. Le uuid identifie la validation pour que vous puissiez interroger son statut et son résultat.
{
"status": "success",
"data": {
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
}
}| Champ | Type | Description |
|---|---|---|
uuid | string | Identifiant de la validation créée. |
Erreurs
| Code | HTTP | Quand |
|---|---|---|
1308 | 400 | Aucun fichier n'a été envoyé. |
1312 | 400 | Plus d'un fichier a été envoyé. |
1309 | 400 | Type MIME non accepté. |
1310 | 400 | Extension non acceptée. |
1311 | 400 / 503 | Le fichier a échoué à l'analyse de sécurité ou n'a pas pu être traité. |
1305 | 500 | L'envoi du fichier vers le stockage a échoué. |
1306 | 400 | La mise en file de la vérification du fichier a échoué. |
Les crédits sont vérifiés au traitement, pas à l'envoi
Contrairement à bulk, le nombre d'adresses n'est pas connu avant la lecture du fichier. C'est pourquoi la requête est acceptée même quand votre solde est insuffisant : les crédits manquants apparaissent plus tard, sous le statut CREDITS_ERROR quand vous interrogez la validation.
Étape suivante
Avec le uuid, suivez la progression dans GET /v1/validation/status/{uuid}, qui dans ce cas porte aussi un champ fileStatus avec le statut du fichier.
Endpoints associés
POST /v1/validation/bulk— les mêmes adresses, depuis un tableauPOST /v1/validation/single-email— une adresse, sans attendre
