Skip to content

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/bulk
bash
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 ​

FeldTypPflichtBeschreibung
emailsarrayJaListe 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"
  }
}
FeldTypBeschreibung
uuidstringKennung der erstellten Validierung.

Fehler ​

CodeHTTPWann
1300400Mehr als 10.000 Adressen in der Anfrage.
1304400Nicht genügend Validierungsguthaben.
1302500Speichern der Adressliste fehlgeschlagen.
1303500Erstellen 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 ​

Built with VitePress