POST /v1/validation/file
Reiht die in einer Datei enthaltenen Adressen zur Validierung ein. Gesendet als multipart/form-data mit einem einzigen Feld file.
Er ist asynchron: die Antwort enthält keine Ergebnisse, nur eine uuid, mit der du sie später abrufst. Hast du die Adressen bereits in einem Array, nutze stattdessen POST /v1/validation/bulk.
Jede geprüfte Adresse verbraucht ein Validierungsguthaben.
Endpunkt
POST /v1/validation/filecurl -X POST https://api.mailiqo.com/v1/validation/file \
-H "X-API-KEY: YOUR_API_KEY" \
-F "[email protected]"Anfragekörper
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
file | file | Ja | Eine einzelne Datei mit den zu validierenden Adressen. |
Akzeptierte Endungen: .csv, .xlsx, .txt und .json. Pro Anfrage ist nur eine Datei erlaubt; mehr als eine wird mit 1312 abgelehnt.
Wie die Datei gelesen wird
Jede Kandidatenadresse in der Datei wird validiert und verbraucht ein Guthaben, auch wenn sie nicht wie eine E-Mail aussieht: in dem Fall wird sie als invalid eingestuft. Was kein Kandidat ist, wird weder validiert noch berechnet. Wiederholte Adressen zählen bei jedem Vorkommen.
| Endung | Was als Kandidat zählt |
|---|---|
.txt | Jede nicht leere Zeile ist ein Kandidat. Zeilen werden nicht an Kommas, Semikolons oder Leerzeichen getrennt: [email protected], [email protected] in derselben Zeile ist ein einziger Kandidat, der sich als ungültig erweist. |
.csv | Das Trennzeichen (,, ; oder Tab) wird automatisch erkannt. Eine Spalte enthält E-Mails, wenn mehr als die Hälfte ihrer nicht leeren Zellen ein @ enthält, und jede nicht leere Zelle dieser Spalten ist ein Kandidat. Die erste Zeile wird übersprungen, wenn sie kein @ enthält (Kopfzeile). Andere Spalten (Name, Telefon…) werden ignoriert. |
.xlsx | Dieselbe Regel wie bei .csv, Blatt für Blatt. |
.json | Die gesamte Struktur wird durchlaufen, und jeder Textwert mit @ ist ein Kandidat. Lässt sich das JSON nicht parsen, wird es als .txt gelesen. |
TIP
Setze eine Adresse pro Zeile oder pro Zelle in einer einzigen Spalte, damit die Zählung exakt deinen Adressen entspricht.
Antwort
Code 200. Die uuid identifiziert die Validierung, damit du ihren Status und ihr Ergebnis abfragen kannst.
{
"status": "success",
"data": {
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
}
}| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | Kennung der erstellten Validierung. |
Fehler
| Code | HTTP | Wann |
|---|---|---|
1308 | 400 | Es wurde keine Datei gesendet. |
1312 | 400 | Es wurde mehr als eine Datei gesendet. |
1309 | 400 | MIME-Typ nicht akzeptiert. |
1310 | 400 | Endung nicht akzeptiert. |
1311 | 400 / 503 | Die Datei hat den Sicherheitsscan nicht bestanden oder konnte nicht verarbeitet werden. |
1305 | 500 | Hochladen der Datei in den Speicher fehlgeschlagen. |
1306 | 400 | Einreihen der Dateiprüfung fehlgeschlagen. |
Das Guthaben wird bei der Verarbeitung geprüft, nicht beim Hochladen
Anders als bei bulk ist die Anzahl der Adressen erst bekannt, wenn die Datei gelesen wurde. Deshalb wird die Anfrage auch bei knappem Guthaben angenommen: fehlendes Guthaben zeigt sich später als Status CREDITS_ERROR, wenn du die Validierung abfragst.
Nächster Schritt
Verfolge mit der uuid den Fortschritt in GET /v1/validation/status/{uuid}, der in diesem Fall auch ein Feld fileStatus mit dem Dateistatus enthält.
Verwandte Endpunkte
POST /v1/validation/bulk— dieselben Adressen, aus einem ArrayPOST /v1/validation/single-email— eine Adresse, ohne Warten
