POST /v1/validation/bulk
Mette in coda una lista di indirizzi per la validazione. Massimo 10.000 per richiesta.
È asincrono: la risposta non contiene risultati, solo uno uuid che usi per leggerli in seguito. Se gli indirizzi sono in un file esportato, usa invece POST /v1/validation/file.
Ogni indirizzo controllato usa un credito di validazione.
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]"]}'Corpo della richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
emails | array | Sì | Lista di indirizzi. Massimo 10.000. |
Risposta
Codice 201. Lo uuid identifica la validazione, così puoi consultarne lo stato e il risultato.
json
{
"status": "success",
"data": {
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
}
}| Campo | Tipo | Descrizione |
|---|---|---|
uuid | string | Identificatore della validazione creata. |
Errori
| Codice | HTTP | Quando |
|---|---|---|
1300 | 400 | Più di 10.000 indirizzi nella richiesta. |
1304 | 400 | Crediti di validazione insufficienti. |
1302 | 500 | Registrazione della lista di indirizzi fallita. |
1303 | 500 | Creazione della richiesta di validazione fallita. |
Il saldo viene controllato prima di accettare il lotto: se non copre tutti gli indirizzi, nulla viene messo in coda e la richiesta viene rifiutata con 1304.
Passo successivo
Con lo uuid, segui l'avanzamento in GET /v1/validation/status/{uuid} e scarica il risultato in GET /v1/validation/details/{uuid}/{page}.
Endpoint correlati
POST /v1/validation/file— gli stessi indirizzi, da un filePOST /v1/validation/single-email— un indirizzo, senza attese
