Skip to content

Empfängervalidierung ​

Bevor Mailiqo eine E-Mail zustellt, prüft es, dass der Empfänger existiert und erreichbar ist. Das schützt deine Absenderreputation: jeder Bounce schadet ihr, und eine schlechte Reputation schickt deine E-Mails in den Spam, selbst wenn sie legitim sind.

Es gibt zwei Prüfstufen:

Was sie tutKosten
BasisFormat, Domain, MX-Einträge und bereits bekannte ErgebnisseIn jedem Plan enthalten
ErweitertPrüft zusätzlich das Postfach beim ZielserverEin Guthaben pro neuer Prüfung; ein gültiges Ergebnis wiederzuverwenden ist kostenlos

Geht dir das Guthaben aus, wird der Versand nicht blockiert: die übrigen Empfänger werden mit der Basisvalidierung geprüft.

Woher die Konfiguration kommt ​

Die Konfiguration liegt auf jeder Absenderdomain, und du legst sie im Kundenbereich fest, im Tab Zustellbarkeit der Domain. Sie gilt gleichermaßen für die API, für SMTP und für Sendungen aus dem Kundenbereich.

Was immer geprüft wird

Das Adressformat, die MX-Einträge der Domain und das Ergebnis früherer Prüfungen gelten bei jedem Versand, unabhängig von der Konfiguration: sie schützen deine Reputation und lassen sich nicht abschalten. Was du unten konfigurierst, ist, wie tief die Prüfung geht und wie streng die Entscheidung ist.

Sie hat drei Teile:

Erweiterte Prüfung — wann das Postfach beim Zielserver abgefragt wird. Das ist der Teil, der ein Validierungsguthaben verbraucht.

WertVerhalten
NEVERDas Postfach wird nie abgefragt; nur die Basisprüfung läuft
UNKNOWN_ONLYNur abgefragt, was noch nicht geprüft und aktuell ist
ALWAYSBei jedem Versand abgefragt, ohne frühere Prüfungen wiederzuverwenden

Nur eine erweiterte Prüfung markiert einen Empfänger als bekannt: eine Basisprüfung bestätigt das Postfach nicht und erspart die Abfrage daher nicht.

Strenge — welche Ergebnisse zum Weitermachen akzeptiert werden.

WertVerhalten
SOFT (präventiv)Verwirft ungültige Adressen und jedes zweifelhafte Ergebnis, das du zum Blockieren markiert hast
STRICT (restriktiv)Nur als gültig bestätigte Empfänger werden akzeptiert

Blockierte Ergebnisse — welche zweifelhaften Fälle du verwerfen willst, wenn die Stufe präventiv ist. Standardmäßig wird nichts blockiert: ein zweifelhaftes Ergebnis wird trotzdem gesendet. Hake nur an, was du lieber verwirfst.

ErgebnisWas es bedeutet
catch_allDie Domain nimmt jede Adresse an, das Postfach lässt sich also nicht bestätigen
riskyDie Adresse existiert, zeigt aber Anzeichen geringer Qualität oder einer Spam-Falle
unknownDer Zielserver hat nicht rechtzeitig geantwortet

Alles invalid wird immer verworfen, unabhängig von der Konfiguration.

Validierung für einen einzelnen Versand anpassen ​

Braucht ein Versand mehr Sorgfalt als üblich — eine Bestellbestätigung, ein Zurücksetzen des Passworts — kannst du ihn direkt in der Anfrage mit dem Objekt validation anpassen. Es ist optional: ohne gilt die Domain-Konfiguration.

Wo es verwendet wird

Das Objekt validation und force_validation werden an beiden Sende-Endpunkten akzeptiert: POST /mailing/send und POST /mailing/send-template.

Ein SMTP-Gegenstück gibt es nicht: SMTP-Sendungen verwenden immer die Domain-Konfiguration. Und wenn du Adressen prüfen willst, ohne ihnen etwas zu senden, suchst du die Validierungs-API.

json
{
  "from": "[email protected]",
  "to": "[email protected]",
  "subject": "Bestätige deine Bestellung",
  "body_html": "<p>Danke für deinen Einkauf.</p>",
  "validation": {
    "mode": "always",
    "level": "restrictive"
  }
}
FeldWerteBeschreibung
modeunknown_only, alwaysWann das Postfach abgefragt wird
levelpreventive, restrictiveWie anspruchsvoll sie ist
blockListe aus catch_all, risky, unknownZweifelhafte Ergebnisse, die du für diesen Versand verwirfst

Wie es auf die Domain-Konfiguration abgebildet wird ​

Kundenbereich und Anfrage nennen dieselben Dinge auf zwei verschiedene Arten. Diese Tabelle führt sie zusammen:

Domain-KonfigurationWert in der AnfrageWirkung
Erweiterte Prüfung NEVER(nicht verfügbar)Eine Anfrage kann nur verschärfen, nie abschalten
Erweiterte Prüfung UNKNOWN_ONLYmode: "unknown_only"Fragt nur ab, was noch nicht geprüft ist
Erweiterte Prüfung ALWAYSmode: "always"Fragt bei jedem Versand ab
Strenge SOFT (präventiv)level: "preventive"Verwirft ungültige Adressen und was du in block setzt
Strenge STRICT (restriktiv)level: "restrictive"Akzeptiert nur als gültig bestätigte Empfänger
Blockierte Ergebnisseblock: ["catch_all", "risky", "unknown"]Werden zu dem ergänzt, was die Domain ohnehin blockiert

Groß- und Kleinschreibung spielt keine Rolle. Aus Kompatibilitätsgründen werden in beiden Feldern auch soft und strict akzeptiert, aber sie bedeuten nicht in jedem dasselbe (mode: "strict" entspricht always, während level: "strict" restrictive entspricht). Verwende unknown_only/always und preventive/restrictive, die eindeutig sind.

Ein Versand kann nur verschärfen

Die Anpassung lockert nie die Domain-Konfiguration. Fragt deine Domain bereits bei jedem Versand ab und die Anfrage verlangt unknown_only, bleibt es bei always. Und block ergänzt nur: blockiert deine Domain bereits risky, kann ein Versand diese Sperre nicht durch Weglassen aufheben.

Deshalb wird never aus der Anfrage nicht akzeptiert: ein Versand kann mehr Prüfung verlangen, nie weniger.

Ein unbekannter Wert liefert 400 mit Code 1419.

force_validation ​

force_validation: true führt beim Senden für jeden Empfänger eine neue Prüfung aus, statt sie mit einem früheren Ergebnis aufzulösen. Es ist die Abkürzung für validation.mode: "always" und verbraucht daher ein Guthaben pro geprüftem Empfänger.

Es ändert nicht, wie anspruchsvoll die Prüfung ist: eine erzwungene Prüfung lockert die Versandrichtlinie nie. Und hast du kein Guthaben mehr, wird der Versand nicht blockiert: die Prüfung läuft als Basisprüfung, und das Ergebnis zeigt das mit advanced: false.

Eine technische Neuzustellung desselben Versands prüft und berechnet nicht erneut: das Ergebnis, das dieser Vorgang bereits gespeichert hat, wird wiederverwendet.

Das Ergebnis lesen ​

Die erweiterte Validierung läuft während des Versands, nachdem die API dir schon geantwortet hat. Deshalb enthält die Antwort von POST /send kein Ergebnis pro Empfänger: wenn du sie bekommst, hat die Prüfung noch nicht stattgefunden.

Was die Antwort liefert, sind die vor dem Einreihen verworfenen Empfänger unter rejected_recipients, mit ihrem Grund: falsches Format, oder ein früheres Ergebnis, das deine Konfiguration nicht akzeptiert.

Das vollständige Ergebnis steht im Detail jedes Empfängers:

GET /v1/mailing/email-message/{uuid}
json
{
  "status": "success",
  "data": {
    "uuid": "9f1c...",
    "recipient_email": "[email protected]",
    "status": "rejected",
    "validation": {
      "checked": true,
      "pending": false,
      "advanced": true,
      "reused": false,
      "classification": "catch_all",
      "reason": "Mailbox not verifiable",
      "reason_code": "mailbox_not_verifiable",
      "checked_at": "2026-01-01T10:29:07+00:00"
    }
  }
}
FeldBeschreibung
checkedEin Validierungsergebnis liegt bereits vor
pendingZur Prüfung vorgemerkt, aber der Versand hat noch nicht validiert
advancedDie Prüfung hat das Postfach abgefragt. Beschreibt den technischen Umfang, nicht die Berechnung
reusedDas Ergebnis hat eine noch gültige Prüfung von dir wiederverwendet, ohne Guthaben zu verbrauchen
classificationvalid, catch_all, risky, unknown oder invalid. null, wenn noch nicht geprüft
reasonLesbarer Grund vom Validator. null, wenn noch nicht geprüft
reason_codeStabiler Code für den Grund. null, wenn noch nicht geprüft
checked_atDatum der Prüfung, nicht des Versands: die Wiederverwendung eines früheren Ergebnisses erneuert es nicht

Das Objekt validation ist immer vorhanden. Gibt es noch kein Ergebnis, ist checked false, und die Ergebnisfelder kommen als null zurück.

Wenn die Validierung einen Empfänger verwirft, wird sein status zu rejected, und der Grund erscheint auch in error_message.

Die UUID jedes Empfängers bekommst du aus email_messages, wenn du GET /email-request/{uuid} aufrufst. Frage jeden mit GET /email-message/{uuid} ab, um seinen Block validation zu lesen: ob er noch pending ist, was checked wurde und ob die Prüfung advanced war.

Validierungsguthaben ​

Berechnet wird das Ausführen einer neuen erweiterten Prüfung, egal über welchen Kanal: Versand-API, SMTP, Validierungs-API oder Kundenbereich. Eine noch gültige Prüfung von dir nachzuschlagen oder wiederzuverwenden verbraucht kein weiteres Guthaben, und die Basisprüfung verbraucht nie welches.

Eine ausgeführte Prüfung wird auch dann berechnet, wenn sie die Adresse als ungültig einstuft oder das Ergebnis als unknown belässt: du zahlst für die Prüfung, nicht für das Urteil. Verhindert ein interner Fehler ihren Abschluss, wird das Guthaben zurückerstattet.

Guthaben kommt aus zwei Quellen:

  • In deinem Plan enthalten: erneuert sich jeden Monat und verfällt mit Ende des Zyklus.
  • In Paketen gekauft: verfällt 12 Monate nach dem Kauf.

Es wird immer zuerst das Guthaben verbraucht, das am frühesten verfällt, also das Plan-Guthaben vor dem gekauften. Dein Guthaben kannst du im Kundenbereich einsehen und dort Pakete kaufen sowie das automatische Aufladen aktivieren, damit ein Paket gekauft wird, sobald das Guthaben unter das von dir gesetzte Minimum fällt.

Verlangst du bei einem Versand eine erweiterte Validierung und hast kein Guthaben mehr, wird der Versand nicht blockiert: die Prüfung fällt auf die Basisprüfung zurück, und das Ergebnis meldet das mit validation.advanced auf false. Bei der Validierungs-API lehnt aufgebrauchtes Guthaben die Anfrage dagegen ab.

Built with VitePress