Einzelne E-Mail-Validierung

Validieren Sie eine E-Mail-Adresse in Echtzeit, bevor Sie eine Nachricht senden. MailLand führt eine 5-stufige Validierungspipeline durch: Syntaxprüfung, Tippfehler-Erkennung, Wegwerf-Domain-Erkennung, Rollenkonten-Erkennung und SMTP-Verifizierung.

AuthentifizierungLink zum Abschnitt kopieren

Fügen Sie Ihren API-Schlüssel im Header X-API-Key ein:

X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD...

Die Anmeldedaten müssen ein Validation-Produkt-Credential mit aktiviertem Api-Kanal sein.

E-Mail validierenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/validation/email

{
  "email": "[email protected]",
  "verify_smtp": true
}

curl -X POST https://api.mail.land/v1/validation/email \
  -H "X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "verify_smtp": true }'

AntwortLink zum Abschnitt kopieren

{
  "email": "[email protected]",
  "result": "Deliverable",
  "score": 95,
  "syntax": {
    "is_valid": true,
    "suggestion": null,
    "domain": "example.com",
    "local_part": "user",
    "has_typo": false,
    "typo_type": null,
    "typo_confidence": null
  },
  "disposable": {
    "is_disposable": false
  },
  "role": {
    "is_role_account": false
  },
  "mx": {
    "has_mx": true,
    "records": ["mx1.example.com", "mx2.example.com"],
    "accepts_mail": true
  },
  "smtp": {
    "can_connect": true,
    "is_deliverable": true,
    "is_catch_all": false,
    "has_full_inbox": false,
    "is_disabled": false,
    "reachability": "safe",
    "error_type": null,
    "error_message": null
  },
  "provider": {
    "name": "Unknown",
    "type": "unknown"
  },
  "cached": false,
  "verified_at": "2026-02-17T12:34:56Z"
}

ErgebnistypenLink zum Abschnitt kopieren

BewertungsanpassungenLink zum Abschnitt kopieren

Die Basisbewertung wird anhand von Risikofaktoren angepasst:

ValidierungspipelineLink zum Abschnitt kopieren

MailLand validiert jede E-Mail in 5 Schritten:

Tippfehler-ErkennungLink zum Abschnitt kopieren

MailLand verwendet eine 3-stufige Tippfehler-Erkennung für häufige Domain-Fehler:

Wenn ein Tippfehler erkannt wird, enthält das Feld syntax.suggestion die korrigierte Adresse:

{
  "email": "[email protected]",
  "result": "Invalid",
  "score": 5,
  "syntax": {
    "is_valid": true,
    "suggestion": "[email protected]",
    "domain": "gmial.com",
    "local_part": "user",
    "has_typo": true,
    "typo_type": "levenshtein",
    "typo_confidence": 95
  }
}

AnbietererkennungLink zum Abschnitt kopieren

MailLand identifiziert den E-Mail-Anbieter anhand von Domainnamen und MX-Einträgen:

SMTP-PrüfungsdetailsLink zum Abschnitt kopieren

Das smtp-Objekt enthält detaillierte SMTP-Verifizierungsergebnisse:

SMTP-FehlertypenLink zum Abschnitt kopieren

GuthabenLink zum Abschnitt kopieren

Jede Validierung verbraucht ein Guthaben aus Ihrem monatlichen Kontingent. Bestimmte Validierungen sind kostenlos (kein Guthaben wird verbraucht):

Prüfen Sie Ihr Guthaben:

GET https://api.mail.land/v1/validation/credits

{
  "monthly_quota": 1000,
  "used": 450,
  "remaining": 550,
  "resets_at": "2026-03-01T00:00:00Z"
}

Das Guthaben wird automatisch am ersten Tag jedes Monats (UTC) zurückgesetzt.

ZwischenspeicherungLink zum Abschnitt kopieren

Validierungsergebnisse werden in Redis zwischengespeichert, um redundante Prüfungen zu vermeiden:

Zwischengespeicherte Antworten haben cached: true in der Antwort. Das ursprüngliche Guthaben wurde verbraucht, als das Ergebnis erstmals berechnet wurde.

FehlerantwortenLink zum Abschnitt kopieren

Nächste SchritteLink zum Abschnitt kopieren

• Batch-Validierung: Validierung von E-Mail-Listen in großen Mengen
• Unterdrückungslisten: Unterdrückungslisten verwalten
• REST API: E-Mails an validierte Adressen senden