Zur Dokumentation springen
API

Noch nicht gebaut

Aufgeführt statt weggelassen.

Was fehlt

Noch nicht verfügbar

Es durch Ausprobieren herauszufinden ist schlimmer, als es gesagt zu bekommen. Nichts davon existiert heute:

  • Eine Zustellung wird bis zu fünfmal versucht: sofort, dann nach 1 Minute, 5, 25 und 2 Stunden. Jeder Versuch wird erfasst und ist über GET /webhooks/{id}/deliveries lesbar, jeweils mit attempt und maxAttempts. Die Wiederholung endet vorzeitig, wenn die Antwort sagt, dass eine Wiederholung sinnlos ist: Alles außer 408, 425, 429 oder einem 5xx gilt als bewusste Ablehnung. Einen Replay-Endpunkt gibt es weiterhin nicht, sodass ein Endpunkt, der länger als dieses Fenster ausfällt, eine Lücke hat – und im Zustellprotokoll finden Sie sie.
  • Eine zurückgewiesene Nachricht liest sich über GET /emails weiterhin als sent: Der Zustellbericht wird dem Original zugeordnet und am Thread beschriftet, aber nichts schreibt in die Versandzeile zurück, deren status keinen Bounce-Zustand kennt. Die Sperrliste, die daraus gespeist wird, ist real: Ein Hard Bounce oder eine Beschwerde setzt die Adresse auf die Sperrliste dieses Workspace, und der nächste Versand dorthin wird abgelehnt. Es ist der Versanddatensatz, der nicht dazulernt.
  • Kein allgemeiner Rate Limiter für Anfragen. Zwei gezählte Obergrenzen existieren allerdings, und beide antworten mit 429: Ein Workspace, der das in seinem Tarif enthaltene monatliche Sendekontingent aufbraucht, erhält send_quota_exceeded bei jedem weiteren Versand bis zum Monatsersten, und das Erzeugen von Wegwerf-Postfächern ist pro Client auf sechs pro Stunde und dreißig pro Tag begrenzt, mit too_many_inboxes. Keine von beiden trägt ein Retry-After. Ein Limiter für die Rate gewöhnlicher Lese- und Schreibvorgänge ist eine Leerstelle und kein Versprechen – eine, die behoben wird.
  • Kein UPLOAD-Endpunkt für Anhänge in der API. Inline-Anhänge sind base64 und über die gesamte Nachricht auf 5 MB begrenzt. Eine größere Datei wird als { fileId } gesendet, das eine bereits im Workspace liegende Datei benennt, und reist als Download-Link. Anhänge aus empfangener Post zu lesen funktioniert sehr wohl.