API-Fehler
Jede Fehlerantwort enthält error.code und error.message; ein 429 wegen eines Versandlimits enthält zusätzlich error.reason und, wenn Warten hilft, Retry-After. Siehe API-Referenz.
| Code | Status | Bedeutung | Tun | Wiederholen |
|---|---|---|---|---|
invalid_request |
400 | Die Anfrage ist fehlerhaft oder enthält unbekannte Felder. | Korrigieren Sie Body oder Abfrage. | Nach Korrektur der Anfrage |
unauthorized |
401 | Der API-Schlüssel fehlt, ist falsch, widerrufen oder abgelaufen. | Verwenden Sie einen gültigen API-Schlüssel. | Nach Korrektur der Anfrage |
account_suspended |
403 | Ihre Organisation ist gesperrt. | Wenden Sie sich an den Support. | Gelingt nicht |
activation_inactive |
403 | Der Versand ist für diese Installation nicht aktiviert. | Wenden Sie sich an den Support. | Gelingt nicht |
activation_scope_mismatch |
403 | Der Schlüssel liegt außerhalb des aktivierten Versandbereichs. | Verwenden Sie einen Schlüssel für das aktivierte Projekt und den aktivierten Stream. | Nach Korrektur der Anfrage |
customer_grant_required |
403 | Dieser Absender hat keine Versandberechtigung. | Schließen Sie die Domain-Einrichtung ab oder wenden Sie sich an den Support. | Gelingt nicht |
customer_price_authority_required |
403 | Ihr Tarif erlaubt derzeit keinen Versand. | Wenden Sie sich an den Support. | Gelingt nicht |
customer_stream_paused |
403 | Der Versand auf diesem Stream ist zur Prüfung pausiert. | Wenden Sie sich an den Support; diese Pause können Sie nicht selbst aufheben. | Gelingt nicht |
environment_mismatch |
403 | Dieser Endpunkt braucht einen Test-API-Schlüssel; ein Live-Schlüssel liest keine erfasste Testmail. | Verwenden Sie für /v1/test-Endpunkte einen Test-API-Schlüssel. | Nach Korrektur der Anfrage |
forbidden |
403 | Dem API-Schlüssel fehlt das Recht für diese Aktion. | Verwenden Sie einen Schlüssel mit dem nötigen Recht. | Nach Korrektur der Anfrage |
recipient_not_allowlisted |
403 | Der Empfänger ist in diesem Modus nicht erlaubt. | Verwenden Sie einen erlaubten Empfänger. | Nach Korrektur der Anfrage |
sender_not_activated |
403 | Der Absender ist nicht die aktivierte Identität. | Senden Sie vom aktivierten Absender. | Nach Korrektur der Anfrage |
not_found |
404 | Die Ressource existiert nicht oder ist für diesen Schlüssel nicht sichtbar. | Prüfen Sie die ID und das Projekt des Schlüssels. | Gelingt nicht |
idempotency_conflict |
409 | Der Idempotency-Key wurde bereits mit anderem Inhalt verwendet. | Verwenden Sie für neuen Inhalt einen neuen Schlüssel; nutzen Sie einen Schlüssel nie für eine andere Nachricht. | Nach Korrektur der Anfrage |
too_late_to_cancel |
409 | Die Nachricht wurde bereits übergeben oder ist abgeschlossen. | Lesen Sie den Status der Nachricht; sie lässt sich nicht zurückholen. | Gelingt nicht |
content_too_large |
413 | Betreff oder Inhalt überschreiten die Größengrenze. | Kürzen Sie den Inhalt. | Nach Korrektur der Anfrage |
request_too_large |
413 | Die Anfrage überschreitet die Größengrenze. | Senden Sie eine kleinere Anfrage. | Nach Korrektur der Anfrage |
customer_payload_limit |
422 | Die Nachricht überschreitet Ihre eingestellte Größengrenze. | Senden Sie eine kleinere Nachricht. | Nach Korrektur der Anfrage |
feature_not_enabled |
422 | Ein angefragtes Feld wird noch nicht unterstützt. | Entfernen Sie das nicht unterstützte Feld. | Nach Korrektur der Anfrage |
identity_not_authorized |
422 | Stream oder Absender sind für diesen Schlüssel nicht freigegeben. | Verwenden Sie den Stream und Absender, die beim Schlüssel angezeigt werden. | Nach Korrektur der Anfrage |
invalid_expiry |
422 | expires_at muss innerhalb der nächsten 24 Stunden liegen. | Wählen Sie ein gültiges Ablaufdatum. | Nach Korrektur der Anfrage |
invalid_mailbox |
422 | Eine E-Mail-Adresse ist ungültig. | Korrigieren Sie die Adresse. | Nach Korrektur der Anfrage |
invalid_page_size |
422 | Die angefragte Seitengröße liegt außerhalb des erlaubten Bereichs. | Verwenden Sie eine unterstützte Seitengröße. | Nach Korrektur der Anfrage |
invalid_subject |
422 | Der Betreff enthält Steuerzeichen. | Entfernen Sie die Steuerzeichen. | Nach Korrektur der Anfrage |
activation_cap_reached |
429 | Das Versandlimit der Aktivierung wurde erreicht. | Wenden Sie sich an den Support. | Gelingt nicht |
customer_grant_cap_reached |
429 | Ein Limit der Berechtigung dieses Absenders wurde erreicht; error.reason nennt es. | Warten Sie Retry-After ab, wenn vorhanden, und wiederholen Sie mit demselben Idempotency-Key; ohne Retry-After wenden Sie sich an den Support. | Gleicher Schlüssel und Body |
customer_proof_cap_reached |
429 | Eines Ihrer Versandlimits wurde erreicht; error.reason nennt es. | Warten Sie Retry-After ab, wenn vorhanden, und wiederholen Sie mit demselben Idempotency-Key; ohne Retry-After wenden Sie sich an den Support. | Gleicher Schlüssel und Body |
customer_shared_cap_reached |
429 | Der Dienst hat ein gemeinsames Limit erreicht (error.reason service_capacity). | Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key. | Gleicher Schlüssel und Body |
quota_exceeded |
429 | Ein Versandlimit wurde erreicht. | Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key. | Gleicher Schlüssel und Body |
test_allowance_exceeded |
429 | Das Testkontingent für erfasste Mails ist erreicht; error.reason nennt die Grenze. | Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key; erfasste Mails verfallen nach sieben Tagen. | Gleicher Schlüssel und Body |
service_unavailable |
503 | Vorübergehend nicht verfügbar, oder das Ergebnis Ihrer Anfrage ist unklar. | Wiederholen Sie mit demselben Idempotency-Key und Body; wurde sie angenommen, erhalten Sie das ursprüngliche Ergebnis. | Gleicher Schlüssel und Body |