Appearance
13. Troubleshooting
Nach Symptom und API-Fehlercode.
Ziel
Ihr findet zu einem konkreten Symptom oder API-Fehlercode direkt die richtige Stelle im Handbuch.
Voraussetzung
Keine — dieses Kapitel ist zum gezielten Nachschlagen gedacht.
Nach HTTP-Status
| Status | Bedeutung | Weiter mit |
|---|---|---|
401 | API-Key fehlt, ist ungültig, abgelaufen oder widerrufen | Kapitel 4 |
404 (bei GET /v1/message/{id}) | Nachricht existiert nicht oder gehört einem anderen Mandanten | Kapitel 4 |
409 dispatch_capacity_unavailable | Kein Kontingent frei, accept_hold=false gesetzt; retryable: true | Kapitel 6 |
422 | Validierungsfehler — die Antwort nennt das betroffene Feld | Kapitel 4/5 |
Nach Nachrichtenstatus
| Status + Code | Bedeutung | Wer handelt |
|---|---|---|
held + paced:tageskontingent / paced:zieldomain-anteil | Tageskontingent ausgeschöpft | läuft automatisch weiter — Kapitel 6 |
held + gated:receiver-red | Empfänger-Gate rot | ihr, Fallback prüfen — Kapitel 8 |
held + transport_hold | eigene Störung bei Host Universe | Host Universe, bereits informiert — Kapitel 8 |
deferred | vorübergehender Zustellfehler (Soft Bounce), Empfängerserver versucht automatisch erneut | keine Aktion nötig — Kapitel 7 |
bounced + adressbezogener Code (z. B. Adresse unbekannt) | Adresse wird automatisch gesperrt | keine Aktion nötig — Kapitel 7 |
bounced + Authentifizierungsfehler beim Empfänger | eigene SPF/DKIM/DMARC-Einrichtung prüfen | ihr — Kapitel 3 |
complained | Empfänger hat "Als Spam melden" geklickt | Ursache/Häufigkeit im Stream prüfen — Kapitel 5/7 |
Webhook kommt nicht an
- Antwortet euer Endpunkt mit
2xxinnerhalb kurzer Zeit? Nur dann gilt die Zustellung als erfolgreich (Kapitel 10). - Ist das Event in der Webhook-Konfiguration überhaupt abonniert?
- Nach einer Secret-Rotation: prüft sowohl
X-Dispatch-Signatureals auch — innerhalb der 7-Tage-Übergangsfrist —X-Dispatch-Signature-Previous(Kapitel 10).
Ergebnis
Ihr findet zu einem konkreten Fehler schnell die richtige Ursache und die passende Kapitelstelle für die Lösung.