# Versionierung

> Die Emailit-API liegt in Version 2 vor. Wie die Version festgelegt wird, was sich ohne neue Version ändert, die veraltete API v1 und die Umstellung auf Objekt-IDs mit Präfix.

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

| Version | Basis-URL | Status |
| --- | --- | --- |
| v2 | `https://api.emailit.com/v2` | Aktuell. Veröffentlicht im Oktober 2025. Alles in dieser Referenz bezieht sich auf v2. |
| v1 | `https://api.emailit.com/v1` | Veraltet. Die vorherige Generation der API. Sie erhält keine neuen Funktionen und wird nicht mehr dokumentiert. |

Wenn Sie noch v1 aufrufen, stellen Sie Ihre Integration auf v2 um. Die [SDKs](/de/docs/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](/de/docs/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](/de/docs/api-reference/#object-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

  - [Changelog](/de/docs/changelog/): Neue Funktionen und Änderungen, die neuesten zuerst.
  - [API-Referenz](/de/docs/api-reference/): Basis-URL, Authentifizierung und Ressourcen.

---
Quelle: https://emailit.com/de/docs/api-reference/versioning/