POST /v1/validation/file
Mette in coda per la validazione gli indirizzi contenuti in un file. Si invia come multipart/form-data con un unico campo file.
È asincrono: la risposta non contiene risultati, solo uno uuid che usi per leggerli in seguito. Se hai già gli indirizzi in un array, usa invece POST /v1/validation/bulk.
Ogni indirizzo controllato usa un credito di validazione.
Endpoint
POST /v1/validation/filecurl -X POST https://api.mailiqo.com/v1/validation/file \
-H "X-API-KEY: YOUR_API_KEY" \
-F "[email protected]"Corpo della richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
file | file | Sì | Un unico file con gli indirizzi da validare. |
Estensioni accettate: .csv, .xlsx, .txt e .json. È consentito un solo file per richiesta; inviarne più di uno viene rifiutato con 1312.
Come viene letto il file
Ogni indirizzo candidato nel file viene validato e usa un credito, anche se non ha la forma di un'email: in quel caso viene classificato come invalid. Tutto ciò che non è un candidato non viene né validato né addebitato. Gli indirizzi ripetuti contano ogni volta che compaiono.
| Estensione | Cosa conta come candidato |
|---|---|
.txt | Ogni riga non vuota è un candidato. Le righe non vengono divise su virgole, punti e virgola o spazi: [email protected], [email protected] sulla stessa riga è un unico candidato, che risulta non valido. |
.csv | Il delimitatore (,, ; o tab) viene rilevato automaticamente. Una colonna contiene email quando più della metà delle sue celle non vuote contiene @, e ogni cella non vuota di quelle colonne è un candidato. La prima riga viene saltata se non contiene @ (intestazione). Le altre colonne (nome, telefono…) vengono ignorate. |
.xlsx | La stessa regola del .csv, foglio per foglio. |
.json | Viene percorsa tutta la struttura e ogni valore di testo che contiene @ è un candidato. Se il JSON non si può analizzare, viene letto come .txt. |
TIP
Metti un indirizzo per riga, o per cella in un'unica colonna, così il conteggio corrisponde esattamente ai tuoi indirizzi.
Risposta
Codice 200. Lo uuid identifica la validazione, così puoi consultarne lo stato e il risultato.
{
"status": "success",
"data": {
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
}
}| Campo | Tipo | Descrizione |
|---|---|---|
uuid | string | Identificatore della validazione creata. |
Errori
| Codice | HTTP | Quando |
|---|---|---|
1308 | 400 | Nessun file inviato. |
1312 | 400 | Inviato più di un file. |
1309 | 400 | Tipo MIME non accettato. |
1310 | 400 | Estensione non accettata. |
1311 | 400 / 503 | Il file non ha superato la scansione di sicurezza o non è stato possibile elaborarlo. |
1305 | 500 | Caricamento del file nello storage fallito. |
1306 | 400 | Accodamento del controllo del file fallito. |
I crediti si controllano all'elaborazione, non al caricamento
A differenza di bulk, il numero di indirizzi non si conosce finché il file non viene letto. Per questo la richiesta viene accettata anche se il tuo saldo è insufficiente: i crediti mancanti emergono dopo, come stato CREDITS_ERROR quando consulti la validazione.
Passo successivo
Con lo uuid, segui l'avanzamento in GET /v1/validation/status/{uuid}, che in questo caso contiene anche un campo fileStatus con lo stato del file.
Endpoint correlati
POST /v1/validation/bulk— gli stessi indirizzi, da un arrayPOST /v1/validation/single-email— un indirizzo, senza attese
