POST /v1/validation/bulk
Met en file une liste d'adresses pour validation. Maximum 10 000 par requête.
C'est asynchrone : la réponse ne contient aucun résultat, seulement un uuid que vous utilisez pour les lire ensuite. Si les adresses se trouvent dans un fichier exporté, utilisez plutôt POST /v1/validation/file.
Chaque adresse vérifiée utilise un crédit de validation.
Endpoint
http
POST /v1/validation/bulkbash
curl -X POST https://api.mailiqo.com/v1/validation/bulk \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"emails": ["[email protected]", "[email protected]"]}'Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
emails | array | Oui | Liste d'adresses. Maximum 10 000. |
Réponse
Code 201. 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"
}
}| Champ | Type | Description |
|---|---|---|
uuid | string | Identifiant de la validation créée. |
Erreurs
| Code | HTTP | Quand |
|---|---|---|
1300 | 400 | Plus de 10 000 adresses dans la requête. |
1304 | 400 | Pas assez de crédits de validation. |
1302 | 500 | L'enregistrement de la liste d'adresses a échoué. |
1303 | 500 | La création de la demande de validation a échoué. |
Le solde est vérifié avant l'acceptation du lot : s'il ne couvre pas chaque adresse, rien n'est mis en file et la requête est rejetée avec 1304.
Étape suivante
Avec le uuid, suivez la progression dans GET /v1/validation/status/{uuid} et téléchargez le résultat dans GET /v1/validation/details/{uuid}/{page}.
Endpoints associés
POST /v1/validation/file— les mêmes adresses, depuis un fichierPOST /v1/validation/single-email— une adresse, sans attendre
