Versionierung

Die API-Version ist Teil der Basis-URL. Jede Anfrage gibt also an, für welche Version sie geschrieben wurde. Diese Seite erklärt, welche Versionen es gibt, was sich innerhalb einer Version ändern kann und wie sich die Objekt-IDs 2026 geändert haben.

Versionen

Wenn Sie noch v1 aufrufen, stellen Sie Ihre Integration auf v2 um. Die SDKs verwenden alle v2.

Änderungen innerhalb von v2

Emailit erweitert v2, ohne die Version in der URL zu ändern. Diese Änderungen können jederzeit erfolgen:

• Neue Endpunkte und Ressourcen.
• Neue optionale Anfrageparameter und Header.
• Neue Felder in Antwortobjekten und Webhook-Payloads.
• Neue Event-Typen, Status und andere Enum-Werte.

Schreiben Sie Clients, die damit zurechtkommen: Ignorieren Sie unbekannte Felder in Antworten, brechen Sie bei einem unbekannten Status oder Event-Typ nicht ab, und verlassen Sie sich nicht auf die Reihenfolge der Felder in einem JSON-Objekt.

Änderungen an der API werden im Changelog angekündigt.

Objekt-IDs

Im Januar 2026 wurden alle Objekte auf IDs mit Präfix umgestellt: ein Typpräfix, gefolgt von 27 Buchstaben und Ziffern, etwa em_4KYof1ZzXndZE2VPi0DgULiekG8 für eine E-Mail oder dom_4K468YrjOkR1wwdhqiO0G9XEUey für eine Domain. Alle Endpunkte nehmen diese IDs an und geben sie zurück. Alle Präfixe finden Sie unter Objekt-IDs.

• Speichern Sie IDs als Strings, und vergleichen Sie sie exakt. Bei IDs wird zwischen Groß- und Kleinschreibung unterschieden.
• Versanddomains, die vor der Umstellung existierten, behalten IDs, die mit sd_ oder sed_ beginnen. Sie funktionieren überall, wo eine dom_-ID funktioniert. Validieren Sie Domain-IDs deshalb nicht anhand des Präfixes.
• API-Schlüssel sind Secrets, keine IDs. Neue Schlüssel beginnen mit secret_, und ältere Schlüssel ohne das Präfix funktionieren weiterhin. Die ID eines API-Schlüssels beginnt mit key_.

Siehe auch