Smart-Mail-Flow API – Änderungen in Version 2.0.0
Smart-Mail-Flow 2.0.0 (15.10.2026) benennt die API-Felder sinnvoll um und ergänzt neue Prüfungen. Die vollständige Beschreibung aller Felder steht auf Smart-Mail-Flow API.
Für Programme, die die API auswerten: Die alten Feldnamen gibt es nicht mehr. Datensätze, die vor der Umstellung eingegangen sind, behalten ihr altes Format. Erkennbar ist das neue Format an debug.software_version (2.0.0 oder höher).
1. Verhalten
| Thema |
bis 1.x |
ab 2.0.0 |
| Test-ID |
beliebig |
mindestens 8 Zeichen, nur A–Z a–z 0–9 _ -. Sonst wird die Mail beim Einliefern abgewiesen (550 5.1.1 id too short bzw. invalid id). postmaster@ und abuse@ werden immer angenommen |
| HTTP-Status der API |
immer 200 |
200 Ergebnis, 400 No token, 404 Token not found, 429 Rate limiter, 500 internal error mit error_id |
| Kopfzeilen und Betreff |
teilweise roh (Zeilenumbrüche, MIME-kodiert) |
eine Zeile, dekodiert |
| TLS 1.2 |
Warnung auf der Website |
gilt als in Ordnung |
| Spamhaus-Abfragename |
Zugangsschlüssel als <key> (verschwand in HTML-Ansichten, sah aus wie „..“) |
[key] |
2. Felder im Datensatz (data)
| alt |
neu |
mail_from (enthielt die From-Kopfzeile) |
header_from |
rcpt_to (enthielt die To-Kopfzeile) |
header_to |
| – |
smtp_mail_from, smtp_rcpt_to (SMTP-Umschlag) |
3. Felder in debug
| alt |
neu |
analysis_version |
entfällt, software_version |
client_ip, smtp.source_ip |
smtp.client_ip |
helo, smtp.helo |
smtp.helo |
env_sender, smtp_mail_from, smtp.smtp_mail_from, spf_output.envelope_from |
smtp.mail_from |
smtp.rcpt |
smtp.rcpt_to |
tls_proto, tls_cipher |
smtp.tls.protocol, smtp.tls.cipher (neu: smtp.tls.status) |
header_from (Adresse) |
header.from[0].address |
return_path |
header.return_path |
spf_output.result/identity/domain/explanation |
spf.result/identity/domain/explanation |
spf_output.raw_header |
mta_checks.spf_header |
dkim_status, dkim_detail |
dkim.result, dkim.detail |
dkim_signatures[] |
dkim.signatures[] |
dkim_signatures[].algorithm |
dkim.signatures[].key_algorithm |
dkim_signatures[].rsa_bits |
dkim.signatures[].key_bits |
dmarc_result |
dmarc.result |
dmarc.policy |
dmarc.published_policy |
dmarc.applied_policy |
dmarc.effective_policy |
envelope_dns |
return_path_dns |
helo_check (helo, status, addresses, reason) |
helo (name, status, addresses, reason) |
protocol |
ip_protocol |
rbl.blacklistmaster |
blacklistmaster |
4. Neue Felder
- Allgemein:
checked_at, duration_ms
- Kopfzeilen:
header.from[] und header.to[] mit address, display_name, display_name_is_address. Dazu header.subject, header.date, header.message_id.
- SPF:
spf.record (ausgewerteter Eintrag), spf.mechanism (entscheidender Teil), spf.dns_lookups, spf.dns_lookup_limit
- DKIM je Signatur:
canonicalization, signed_headers, body_length_limitdns_name, testingbody_hash_ok, aligned_with_from
- DMARC:
subdomain_policy, pct, adkim, aspfdisposition: was nach DMARC mit dieser Mail geschehen soll, none bei pass
- ARC (neu):
arc mit status, chain_validation, sealer_trust und instances[]
- HELO-Teilprüfungen:
helo.syntax, helo.resolves, helo.matches_client_ip
- Blacklists: je Liste zusätzlich
rcode, resolver, duration_ms. query ist immer vorhanden, null wenn die Liste nicht abgefragt wurde.
- Domain-Sicherheit (neu):
domain_security der From-Domain mit dnssec, mta_sts, tls_rpt, dane, bimi
5. Entfallen
analysis_versionenv_senderspf_outputdkim_status, dkim_detail, dkim_signatures (die Spalte dkim_status im Datensatz bleibt)dmarc_resultenvelope_dnshelo_checkprotocolrblclient_ip, tls_proto, tls_cipher auf oberster Ebenedkim_signatures[].rsa_bits (bei ed25519 stand dort "n/a")