Stripe-Versionsverwaltung und Support-Richtlinie
Stripe API-Versionen
Die API-Versionsrichtlinie von Stripe basiert auf dem Veröffentlichungsdatum. Zum Beispiel, 15.01.2023. Wir veröffentlichen eine neue API-Version zusammen mit einer neuen Version des SDK. Was Sie von einer neuen API-Version erwarten können, finden 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.
Stripe Beta SDK-Versionen
Mit Beta-SDKs können Sie auf bestimmte Stripe-Produkte und -Funktionen in der Beta-Phase zugreifen. Die Versionen dieser Beta-SDKs haben das Suffix beta
oder b
, zum Beispiel 5.1.0b3 in Python und 5.1.0-beta.3 in anderen Sprach-SDKs. Testen Sie diese Beta-SDKs und teilen Sie uns Ihr Feedback mit, bevor die Funktionen die stabile Phase erreichen. Weitere Informationen zur Verwendung der Beta-SDKs finden Sie in der Readme-Datei im GitHub-Repository zu den einzelnen Sprach-SDKs.
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.