POST /v1/validation/bulk
Reiht eine Liste von Adressen zur Validierung ein. Maximal 10.000 pro Anfrage.
Er ist asynchron: die Antwort enthält keine Ergebnisse, nur eine uuid, mit der du sie später abrufst. Liegen die Adressen in einer exportierten Datei vor, nutze stattdessen POST /v1/validation/file.
Jede geprüfte Adresse verbraucht ein Validierungsguthaben.
Endpunkt
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]"]}'Anfragekörper
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
emails | array | Ja | Liste von Adressen. Maximal 10.000. |
Antwort
Code 201. Die uuid identifiziert die Validierung, damit du ihren Status und ihr Ergebnis abfragen kannst.
json
{
"status": "success",
"data": {
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx"
}
}| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | Kennung der erstellten Validierung. |
Fehler
| Code | HTTP | Wann |
|---|---|---|
1300 | 400 | Mehr als 10.000 Adressen in der Anfrage. |
1304 | 400 | Nicht genügend Validierungsguthaben. |
1302 | 500 | Speichern der Adressliste fehlgeschlagen. |
1303 | 500 | Erstellen der Validierungsanfrage fehlgeschlagen. |
Das Guthaben wird vor der Annahme des Stapels geprüft: deckt es nicht jede Adresse ab, wird nichts eingereiht und die Anfrage mit 1304 abgelehnt.
Nächster Schritt
Verfolge mit der uuid den Fortschritt in GET /v1/validation/status/{uuid} und lade das Ergebnis in GET /v1/validation/details/{uuid}/{page} herunter.
Verwandte Endpunkte
POST /v1/validation/file— dieselben Adressen, aus einer DateiPOST /v1/validation/single-email— eine Adresse, ohne Warten
