Befolgen Sie diese Richtlinien, um sicherzustellen, dass die API-Versionen in Ihrer gesamten Stripe-Integration übereinstimmen.
Ihr Konto hat eine Standard-API-Version, die definiert, wie Sie die API aufrufen, auf welche Funktionen Sie Zugriff haben und was Sie garantiert als Teil der Antwort zurückbekommen. Webhook-Ereignisobjekte basieren auf Ihrer Standard-API-Version, die sich von der im SDK verwendeten API-Version unterscheiden kann. Um sicherzustellen, dass diese Versionen übereinstimmen, empfehlen wir Ihnen die Registrierung eines Webhook-Endpoints mit der gleichen API-Version wie das SDK. Ihre Version finden Sie unter Von API-Anfragen verwendete API-Versionen anzeigen.
Grundlagen der Versionierung
Wählen Sie Ihre SDK-Sprache, um loszulegen. Wenn Sie curl oder die Stripe-CLI anstelle eines SDK verwenden, finden Sie weitere Informationen auf unserer Versionierungsseite.
Einstellen der API-Version
Mit der Stripe-Ruby-Bibliothek können Sie die API-Version global oder auf Anfragebasis festlegen. Wenn Sie keine API-Version festlegen, verwenden neuere Versionen von stripe-ruby die API-Version, die zum Zeitpunkt der Veröffentlichung Ihrer Version von stripe-ruby aktuell war. Versionen von stripe-ruby vor v9 verwenden die Standard-API-Version Ihres Kontos.
Um die API-Version global mit dem SDK festzulegen, weisen Sie der Eigenschaft Stripe.api_version die Version zu:
Oder legen Sie die Version anfragebasiert fest:
Notiz
Wenn Sie die Version global oder anfragebasiert überschreiben, werden die API-Antwortobjekte ebenfalls in dieser Version zurückgegeben.
Ihre API-Version aktualisieren
Vor einem Upgrade Ihrer API-Version sollten Sie die folgenden Ressourcen beachten:
Sie können die Standard-API-Version Ihres Kontos in Workbench aktualisieren. Aktualisieren Sie Ihren Code, um die aktuelle Version des Ruby SDK zu verwenden, und legen Sie die neue API-Version fest, wenn Sie Ihre Aufrufe tätigen.
Siehe auch
Stripe SDKs befolgen ihre eigenen Versionsrichtlinien. Unter folgendem Link erfahren Sie mehr.