Fehler

Fehlerantwort

Jeder Fehler antwortet mit einem stabilen code und einer englischen message für Logs. Entscheiden Sie anhand des Codes, nie anhand der Meldung.

{ "code": "domain_not_verified", "message": "from uses mail.acme.dev, which is not a verified sending domain of this account" }

Jede Antwort enthält einen Header X-Request-Id. Nennen Sie ihn, wenn Sie dem Support schreiben: letr.dev findet die Anfrage damit. Senden Sie eine eigene X-Request-Id (höchstens 64 Buchstaben, Ziffern, - oder _), verwendet letr.dev diese; sonst setzt letr.dev eine. Ein 401 enthält zudem WWW-Authenticate: Bearer.

Codes

Status	Code	Bedeutung
400	invalid_request	Der Inhalt ist kein lesbares JSON, der Idempotency-Key ist länger als 255 Zeichen, oder ein Query-Parameter (cursor, limit, status, q, range) ist ungültig.
401	unauthorized	Kein Key, oder ein unbekannter, widerrufener oder abgelaufener Key.
403	insufficient_permission	Die Berechtigung des Keys erlaubt diese Anfrage nicht.
403	domain_not_allowed	Die Absenderdomain liegt ausserhalb der Domains, auf die der Key beschränkt ist.
403	account_not_active	Das Konto ist nicht aktiv: Die Zahlung steht aus oder es ist deaktiviert.
403	account_paused	Das Konto ist pausiert.
404	not_found	Diese E-Mail, Domain, dieser Webhook oder diese Adresse existiert im Konto nicht.
405	method_not_allowed	Der Pfad existiert, die Methode nicht.
409	domain_exists	Das Konto hat diese Domain bereits.
409	not_scheduled	Die E-Mail wartet nicht mehr auf ihren geplanten Zeitpunkt und lässt sich nicht mehr stornieren.
409	webhook_disabled	Der Endpunkt ist deaktiviert: Pausieren, Fortsetzen oder erneut Senden braucht zuerst einen aktivierten Endpunkt.
413	import_too_large	Ein Import in die Sperrliste hat mehr als 10'000 Zeilen oder 1 MB.
415	unsupported_media_type	Senden Sie Content-Type: application/json; POST /v1/suppressions/import nimmt text/csv.
422	domain_not_verified	Die Absenderdomain ist keine verifizierte Domain des Kontos.
422	recipient_suppressed	Ein Empfänger steht auf der Sperrliste; die Meldung nennt ihn.
422	invalid_from	from fehlt oder ist keine Adresse.
422	invalid_recipients	to ist leer oder eine Adresse ist ungültig.
422	too_many_recipients	Mehr als 50 Empfänger in to, cc und bcc zusammen.
422	invalid_subject	subject fehlt, ist länger als 998 Zeichen oder nicht einzeilig.
422	missing_content	Weder html noch text.
422	invalid_attachment	Fehlender Dateiname, Inhalt nicht in Base64, oder eine ungültige oder doppelte contentId.
422	message_too_large	Die E-Mail ist grösser als 15 MB wie versendet, etwa 10 MB Anhänge.
422	invalid_headers	Zu viele Header, ein ungültiger Name, ein zu langer Wert oder einer mit Zeilenumbruch, oder ein doppelter Name.
422	reserved_header	Ein Header, den letr.dev selbst setzt.
422	invalid_tags	Mehr als 10 Tags, ein ungültiger Name oder ein Wert über 256 Zeichen.
422	invalid_batch	Ein Batch ohne E-Mail oder mit mehr als 100.
422	idempotency_key_reused	Der Idempotency-Key wurde mit einer anderen Anfrage verwendet.
422	invalid_domain	Der Name ist keine Domain.
422	domain_limit_reached	Das Konto hat 20 Domains; entfernen Sie zuerst eine.
422	api_key_expiring	Der Key wird bereits ersetzt; erneuern Sie stattdessen seinen Nachfolger.
422	invalid_webhook_url	Keine öffentliche https-URL.
422	invalid_webhook_events	Kein Ereignistyp oder ein unbekannter.
422	webhook_url_taken	Ein anderer Endpunkt des Kontos hat diese URL.
422	webhook_limit_reached	Das Konto hat 5 Endpunkte; löschen Sie zuerst einen.
422	invalid_scheduled_at	scheduledAt liegt weniger als 1 Minute oder mehr als 7 Tage in der Zukunft.
422	invalid_email	Die Adresse für die Sperrliste oder die E-Mail-Adresse bei der Registrierung ist ungültig.
422	invalid_customer_type	Registrierung: Die Art des Kunden ist weder eine Firma noch eine Privatperson.
422	invalid_use_case	Registrierung: Die Beschreibung, was Sie versenden, ist kürzer als 20 oder länger als 500 Zeichen.
429	monthly_ceiling_reached	Die Monatsobergrenze Ihres Kontos ist erreicht. Wählen Sie unter Abrechnung eine höhere Obergrenze, falls eine angeboten wird, sonst schreiben Sie dem Support.
429	daily_limit_reached	Die Tageslimite Ihres Kontos ist aufgebraucht.
429	rate_limited	Zu viele Anfragen; langsamer senden.
500	internal_error	Bei letr.dev ist etwas fehlgeschlagen.
503	unavailable	letr.dev ist vorübergehend nicht verfügbar; später erneut versuchen.
503	content_busy	Zu viele Inhaltsabrufe gleichzeitig; nach der im Header Retry-After genannten Zeit erneut versuchen.

In einem Batch nennt die Meldung die Position der fehlerhaften E-Mail, zum Beispiel [3].to.