Skip to content

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 ​

http
POST /v1/validation/file
bash
curl -X POST https://api.mailiqo.com/v1/validation/file \
  -H "X-API-KEY: YOUR_API_KEY" \
  -F "[email protected]"

Corps de la requête ​

ChampTypeRequisDescription
filefileOuiUn 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.

ExtensionCe qui compte comme candidat
.txtChaque 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.
.csvLe 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.
.xlsxLa même règle que .csv, feuille par feuille.
.jsonToute 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.

json
{
  "status": "success",
  "data": {
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
  }
}
ChampTypeDescription
uuidstringIdentifiant de la validation créée.

Erreurs ​

CodeHTTPQuand
1308400Aucun fichier n'a été envoyé.
1312400Plus d'un fichier a été envoyé.
1309400Type MIME non accepté.
1310400Extension non acceptée.
1311400 / 503Le fichier a échoué à l'analyse de sécurité ou n'a pas pu être traité.
1305500L'envoi du fichier vers le stockage a échoué.
1306400La 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 ​

Built with VitePress