# API-Upgrades Verfolgen Sie Änderungen und Aktualisierungen an der Stripe-API. > [Thin-Ereignisse](https://docs.stripe.com/event-destinations.md#thin-events) für API v1-Ressourcen sind in einer privaten Vorschau verfügbar. Sie können sie verwenden, um Integrations-Upgrades ohne Änderungen an Ihrer Webhook-Konfiguration zu optimieren. Bislang haben Thin-Ereignisse nur API v2-Ressourcen unterstützt. [Erfahren Sie mehr und beantragen Sie Zugang](https://docs.google.com/forms/d/e/1FAIpQLSeEkqzB02afvlklMkqwA6wsBH90eW8gxmc-hBOvqe2N6TRujQ/viewform?usp=dialog). Ihre API-Version steuert das API- und Webhook-Verhalten, das Sie sehen (zum Beispiel, welche Parameter Sie in Anfragen aufnehmen können, welche Eigenschaften Sie in Antworten sehen usw.). Ihre Version wird festgelegt, wenn Sie zum ersten Mal eine API-Anfrage stellen. Jede Hauptversion, z. B. [Acacia](https://docs.stripe.com/changelog/acacia.md), enthält Änderungen, die nicht abwärtskompatibel mit früheren Versionen sind. Ein Upgrade auf eine neue Hauptversion kann Aktualisierungen des vorhandenen Codes erfordern. Jede monatliche Version enthält nur abwärtskompatible Änderungen und verwendet den gleichen Namen wie die letzte Hauptversion. Sie können sicher ein Upgrade auf eine neue monatliche Version durchführen, ohne bestehenden Code zu beschädigen. Führen Sie [die folgenden Schritte](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api) aus, um Ihre API-Version zu aktualisieren. Wenn eine [Connect-Plattform](https://stripe.com/connect) Anfragen im Namen verbundener Konten stellt, ohne eine API-Version anzugeben, verwendet Stripe immer die API der Plattform. Unabhängig von der API-Version eines verbundenen Kontos geben die Anfragen der Plattform in seinem Namen immer Antworten zurück, die der API-Version der Anfrage entsprechen. ## Abwärtskompatible Änderungen Stripe betrachtet die folgenden Änderungen als abwärtskompatibel: - Hinzufügen neuer API-Ressourcen. - Hinzufügen neuer optionaler Anfrageparameter zu bestehenden API-Methoden. - Hinzufügen neuer Eigenschaften zu bestehenden API-Antworten - Ändern der Reihenfolge der Eigenschaften in vorhandenen API-Antworten. - Ändern der Länge oder des Formats undurchsichtiger Zeichenfolgen, wie z. B. Objekt-IDs, Fehlermeldungen und anderer lesbarer Zeichenfolgen. - Dazu gehört das Hinzufügen oder Entfernen von festen Präfixes (z. B. `ch_` bei Zahlungs-IDs). - Stellen Sie sicher, dass Ihre Integration von Stripe-generierte Objekt-IDs verarbeiten kann, die bis zu 255 Zeichen umfassen können. Wenn Sie beispielsweise MySQL verwenden, speichern Sie die IDs in einer `VARCHAR(255) COLLATE utf8_bin`-Spalte (die `COLLATE`-Konfiguration sorgt für Groß- und Kleinschreibung bei Suchvorgängen). - Hinzufügen neuer Ereignistypen. - Achten Sie darauf, dass Ihr Webhook-Listener ungewohnte Ereignistypen sinnvoll behandelt. ## Ihre API-Version aktualisieren Wenn Sie eine ältere Version der API verwenden, sollten Sie ein Upgrade auf die neueste Version durchführen, um von den neuen Funkteionen und erweiterter Funktionalität zu profitieren. Das Upgrade Ihrer API-Version wirkt sich auf Folgendes aus: - Die API-Aufrufe, die Sie ohne `Stripe-Version`-Header tätigen: die Parameter, die Sie senden können und die Struktur der zurückgegebenen Objekte. - Die Struktur der mit [Stripe.js](https://docs.stripe.com/payments/elements.md)-Methoden empfangenen Objekte, wie z. B. [confirmCardPayment](https://docs.stripe.com/js.md#stripe-confirm-card-payment). - Die Struktur der Objekte, die an Ihre Webhook-Endpoints gesendet werden (sowohl Konto-Objekte als auch [Connect](https://docs.stripe.com/connect/webhooks.md)-Objekte)). Wenn für einen Endpoint jedoch eine explizite Version festgelegt ist, wird immer diese Version verwendet. - Für von Stripe durchgeführte automatisierte Abrechnungsvorgänge (z. B. das Generieren einer *Rechnung* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) für einen neuen Abonnementzeitraum) wird die Standard-API-Version Ihres Kontos verwendet. Im Änderungsprotokoll der API finden Sie nähere Informationen dazu, wie sich Ihre Standard-API auf diese Vorgänge auswirkt. ### Ihre API-Version und das neueste verfügbare Upgrade in Workbench anzeigen Sehen Sie sich die [API-Version, die von den letzten Anfragen für Ihr Konto verwendet wird](https://docs.stripe.com/workbench/guides.md#view-api-versions), und das neueste verfügbare Upgrade auf der Registerkarte [Übersicht](https://dashboard.stripe.com/workbench/overview) in Workbench an. Wenn Sie ein API-Upgrade durchführen, geben Sie in Ihrem Code unbedingt die API-Version an, für die Sie die Integration durchführen, statt die Standard-API-Version Ihres Kontos zu verwenden. Um eine neuere Version für API-Aufrufe zu testen, legen Sie den `Stripe-Version`-Header (in Live- oder Test-Umgebungen) fest. Erfahren Sie, wie Sie die Versionierung in unseren [serverseitigen SDKs](https://docs.stripe.com/sdks.md#server-side-libraries) verwalten. ### Ihre Webhooks aktualisieren und testen Lesen Sie unseren Leitfaden [zum Umgang mit der Webhook-Versionierung](https://docs.stripe.com/webhooks/versioning.md). ### Upgrade durchführen Wenn Sie sicher sind, dass Ihr Code mit der neuesten API-Version umgehen kann, führen Sie das Upgrade mit Workbench durch: 1. Öffnen Sie die Registerkarte [Übersicht](https://dashboard.stripe.com/workbench/overview) in Workbench. 1. Klicken Sie im Abschnitt **API-Versionen** auf **Upgrade verfügbar**. Diese Option wird angezeigt, wenn eine neuere API-Version verfügbar ist. 1. Überprüfen Sie, welche API-Version Ihrem Konto zugewiesen wird, und klicken Sie auf **Upgrade.** Dadurch ändert sich die Version, die von API-Aufrufen verwendet wird, die nicht über den `Stripe-Version`-Header verfügen, ebenso wie die Version, die zum Rendern von Objekten verwendet wird, die an Ihre Webhooks gesendet werden. > Die Form der Ressourcen in [über die API abgerufenen Ereignissen](https://docs.stripe.com/api/events.md) ist durch die Standard-API-Version Ihres Kontos zum Zeitpunkt des Auftretens des Ereignisses definiert. Wenn Ihr Code Ereignisse abruft, die erstellt wurden, als Ihre Standard-API-Version eine andere war, müssen alle Unterschiede in den Ereignisversionen berücksichtigt werden. ### Setzen Sie Ihre API-Version zurück Nachdem Sie Ihre API-Version aktualisiert haben, können Sie 72 Stunden lang in Workbench sicher zu der Version zurückkehren, von der Sie das Upgrade ausgeführt haben. Nach dem Rücksetzen wird versucht, Webhooks, die mit der neuen Objektstruktur gesendet wurden und fehlgeschlagen sind, erneut mit der alten Struktur zu senden. ## Informiert bleiben We send information on new additions and changes to the Stripe API and language libraries in the Stripe Developer Digest. Make sure you [subscribe](https://go.stripe.global/dev-digest) to stay informed about additions and changes. ## API-Versionen > Dieser Abschnitt wird nicht länger aktualisiert. Um mehr über Updates für die Stripe API zu erfahren, besuchen Sie das neue [Änderungsprotokoll](https://docs.stripe.com/changelog.md). Nachfolgend sind alle [wesentlichen Änderungen](https://docs.stripe.com/upgrades.md#breaking-change) an der Stripe-API aufgeführt. Jedes Datum entspricht einer neuen Version der Stripe-API. Alle API-Erweiterungen und -Updates finden Sie im [API-Änderungsprotokoll](https://docs.stripe.com/changelog.md). Wenn Sie nach neuen Produktversionen suchen, schauen Sie sich das [Produktänderungsprotokoll](https://stripe.com/blog/changelog) an.