Skip to content

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 ​

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]"

Corpo della richiesta ​

CampoTipoObbligatorioDescrizione
filefileSì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.

EstensioneCosa conta come candidato
.txtOgni 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.
.csvIl 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.
.xlsxLa stessa regola del .csv, foglio per foglio.
.jsonViene 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.

json
{
  "status": "success",
  "data": {
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
  }
}
CampoTipoDescrizione
uuidstringIdentificatore della validazione creata.

Errori ​

CodiceHTTPQuando
1308400Nessun file inviato.
1312400Inviato più di un file.
1309400Tipo MIME non accettato.
1310400Estensione non accettata.
1311400 / 503Il file non ha superato la scansione di sicurezza o non è stato possibile elaborarlo.
1305500Caricamento del file nello storage fallito.
1306400Accodamento 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 ​

Built with VitePress