Erste Schritte
Fehler und Wiederholungsversuche
Das standardisierte JSON-Fehlerobjekt auswerten und entscheiden, wann ein Wiederholungsversuch sicher ist.
Fehlerobjekt
Fehlgeschlagene JSON-API-Aufrufe liefern ein einziges error-Objekt auf oberster Ebene mit einer lesbaren message, dem numerischen HTTP-status und einem optionalen stabilen code. Der OpenAPI-Vertrag verweist für erwartete und unerwartete Fehler auf dieses Schema.
{
"error": {
"code": "invalid_request",
"message": "A verified From domain is required",
"status": 403
}
}Client-Fehler
Korrigieren Sie Eingabefehler mit 400, bevor Sie es erneut versuchen. Ersetzen oder widerrufen Sie ungültige Zugangsdaten nach einem 401. Ein 402 erfordert eine kostenpflichtige Berechtigung, 403 kennzeichnet eine Richtlinien- oder Berechtigungsgrenze, 404 steht für eine fehlende Ressource im Mandantenbereich, 409 für einen Status- oder Idempotenzkonflikt, 413 für überschrittene Anhangslimits, und 422 umfasst Validierung und Sperrliste.
Entscheidungen über Wiederholungsversuche
Wiederholen Sie Fehler bei Authentifizierung, Validierung, Sperrliste oder Konflikten nicht automatisch. Ein 423 bedeutet, dass genau diese From-Identität pausiert ist: Stoppen Sie diesen Versandstrom, korrigieren Sie seine Empfänger und versuchen Sie es erst erneut, wenn seine rollierenden Kennzahlen wieder unauffällig sind. Vorübergehende Antworten mit 429, 502 oder 503 dürfen mit begrenztem exponentiellem Backoff und Jitter wiederholt werden. Behalten Sie beim Wiederholen eines logischen Versands denselben Idempotency-Key und einen identischen JSON-Payload bei.
Kontext für den Support
Notieren Sie Zeitpunkt der Anfrage, Route, HTTP-Status, SendHQ-Ressourcen-ID und nicht geheime Fehlerfelder. Geben Sie in einer Supportanfrage niemals einen API-Schlüssel, ein Session-Cookie, einen Nachrichteninhalt oder eine Empfängerliste an.