API-Kompatibilität

VersionierungszusageLink zum Abschnitt kopieren

Die API wird im URL-Pfad versioniert. Heute gibt es nur /v1.

• Änderungen an v1 sind ausschließlich additiv. Wir ergänzen Endpunkte, optionale Anfragefelder, Antwortfelder und Ereignistypen. Wir entfernen oder benennen kein Feld um, ändern seine Bedeutung nicht und machen kein optionales Feld verpflichtend. Ihr Client muss unbekannte Antwortfelder ignorieren.
• Eine inkompatible Änderung erscheint als /v2. Wir kündigen sie mindestens 180 Tage vor der Verfügbarkeit an, und /v1 läuft nach der Veröffentlichung von /v2 noch 180 Tage parallel weiter.

Einzelzustellung pro EmpfängerLink zum Abschnitt kopieren

Hat POST /v1/transactional/send mehrere Empfänger in to, erhält jeder Empfänger eine eigene Kopie der Nachricht mit eigener Nachrichten-ID. Es gibt keine gemeinsame Nachricht und kein sichtbares Cc: Kein Empfänger sieht die Adressen der anderen. Die Anfrage akzeptiert weder cc noch bcc. Wenn alle Empfänger einander sehen sollen, ist das in v1 nicht möglich.

Größe von AnhängenLink zum Abschnitt kopieren

Eine Nachricht enthält höchstens 10 Anhänge und insgesamt höchstens 10 MiB, gemessen nach der Base64-Dekodierung. Eine Anfrage über dem Limit wird mit 400 VALIDATION_FAILED abgelehnt. Siehe Anhänge.

Geltungsbereich der IdempotenzLink zum Abschnitt kopieren

X-Idempotency-Key wird an genau zwei Endpunkten akzeptiert: POST /v1/transactional/send und POST /v1/transactional/send-batch. Kein anderer Endpunkt liest ihn, daher kann die Wiederholung jedes anderen POST seine Wirkung wiederholen. Siehe Idempotenz.