Stripe-Versionsverwaltung und Support-Richtlinie
Erfahren Sie mehr über die Versionsverwaltung und die Support-Richtlinie von Stripe.
Stripe API-Versionen
Ab der Version 2024-09-30.acacia folgt Stripe einem neuen API-Veröffentlichungsprozess, bei dem wir monatlich neue API-Versionen ohne Änderungen freigeben. Zweimal im Jahr veröffentlichen wir eine neue Version (zum Beispiel acacia), die mit einer API-Version beginnt, die wichtige Änderungen enthält.
Sie können mit jeder monatlichen API-Version neue Nebenversionen der SDKs und mit jeder der zweimal jährlich erscheinenden Hauptversionen neue Hauptversionen der SDKs erwarten.
Manchmal sehen Sie ein größeres Versionsupdate für die SDKs mit den monatlichen API-Versionsupdates, wenn die SDKs wichtige Änderungen für den Versand enthalten.
Was Sie von einer neuen API-Version erwarten können, erfahren Sie unter API-Upgrades.
Stripe SDK-Versionen
Die SDK-Versionierungsrichtlinie von Stripe basiert auf dem semantischen Versionierungsstandard. In Version 4.3.2 steht beispielsweise 4 für major, 3 für minor und 2 für patch. Wenn wir eine neue SDK-Version mit neuen Funktionen oder Fehlerbehebungen veröffentlichen, wird je nach Art der eingeführten Änderung eine dieser drei Versionskomponenten inkrementiert.
- Major. Wir erweitern die Versionskomponente major, wenn die Version bahnbrechende Änderungen enthält, die mit der letzten Version nicht abwärtskompatibel sind: um einen erforderlichen Parameter hinzuzufügen, ändern Sie einen Typ, eine Eigenschaft, eine Methode oder einen Parameter. Zum Beispiel das Umbenennen der Ausnahmeklassen des SDK.
- Minor. Wir erweitern die Versionskomponente minor, wenn die Version neue Funktionen enthält, die mit der neuesten Version abwärtskompatibel sind: um einen neuen Typ, eine neue Eigenschaft, eine neue Methode, einen neuen optionalen Parameter oder einen unterstützten Parameterwert hinzuzufügen. Zum Beispiel die Erläuterung der Meldung zum Löschen der Metadaten des SDK.
- ** Patch**. Wir erweitern die Versionskomponente patch, wenn die Version abwärtskompatible Fehlerbehebungen enthält: um ein Verhalten zu ändern, wenn durch die Korrektur dieses Verhaltens keine dokumentierten Typen, Eigenschaften, Methoden oder Parameter geändert werden. Zum Beispiel die Behebung eines Fehlers, bei dem Datei-Uploads nicht korrekt aufgelistet wurden.
Sie können neue Funktionen und Verbesserungen in der Vorschau-Phase testen, indem Sie Versionen unserer SDKs mit den Endungen beta oder b verwenden. Beispiel: 5.1.0b3 in Python und 5.1.0-beta.3 in anderen Sprach-SDKs.
Installationsanweisungen oder Details zum Übergeben von Vorschau-Headern im Stripe-Versions-Header finden Sie in den README-Dateien in den jeweiligen SDK-GitHub-Repositorys.
Support-Richtlinie für das Stripe SDK
Neue Funktionen und Fehlerbehebungen werden in der neuesten Hauptversion des SDK veröffentlicht. Wenn Sie eine ältere major SDK-Version verwenden, empfehlen wir ein Upgrade auf die neueste Hauptversion, um diese Funktionen und Fehlerbehebungen zu nutzen. Ältere Hauptversionen des Pakets können weiterhin verwendet werden, erhalten jedoch keine zusätzlichen Updates.
Migrationsleitfäden
Wir stellen Migrationsleitfäden zur Verfügung, um Sie bei der Aktualisierung von älteren SDK-Versionen zu unterstützen. Sie finden sie im Wiki-Bereich unserer SDK-GitHub-Repositorys.