Politique de gestion des versions et de prise en charge Stripe
Versions de l’API Stripe
La politique de gestion des versions des API Stripe fonctionne par date de publication. Par exemple : 15/01/2023. Nous publions les nouvelles versions de l’API en même temps que les nouvelles versions du SDK. Pour comprendre ce qu’implique une nouvelle version de l’API, consultez la page Mises à niveau de l’API.
Versions des SDK Stripe
La politique de gestion des versions du SDK de Stripe repose sur la norme de gestion sémantique des versions. Par exemple dans la version 4.3.2, 4 correspond à une modification majeure, 3 à une modification mineure et 2 à un correctif. Quand nous publions une nouvelle version de SDK contenant de nouvelles fonctionnalités ou des corrections de bogues, nous ajoutons 1 à l’un de ces trois composants de version, selon le type de changement introduit.
- Majeur. Nous changeons le composant de version majeure lorsque la version contient des changements importants, non rétrocompatibles avec la version la plus récente : la version ajoute un paramètre obligatoire ou modifie un type, une propriété, une méthode ou un paramètre. Par exemple si la version renomme les classes d’exceptions du SDK.
- Mineur. Nous changeons le composant de version mineure lorsque la version contient de nouvelles fonctionnalités rétrocompatibles avec la version la plus récente : la version ajoute un nouveau type, une nouvelle propriété, une nouvelle méthode, un nouveau paramètre facultatif ou une nouvelle valeur de paramètre prise en charge. Par exemple si la version clarifie le message de suppression des métadonnées du SDK.
- Correctif. Nous changeons le composant de version corrective lorsque la version contient des corrections de bogues rétrocompatibles : la version modifie un comportement, sans changer les types, propriétés, méthodes ou paramètres documentés. Par exemple, la version corrige un bogue à cause duquel les chargements de fichiers n’étaient pas correctement répertoriés.
Versions bêta des SDK Stripe
Vous pouvez accéder à certains produits et fonctionnalités Stripe au stade bêta avec les SDK bêta. Les versions de ces SDK bêta présentent le suffixe beta
ou b
, par exemple, 5.1.0b3 dans Python et 5.1.0-beta.3 dans les SDK d’autres langages. Essayez ces SDK en version bêta et faites-nous part de vos commentaires avant que les fonctionnalités n’atteignent la phase stable. Pour en savoir plus sur l’utilisation des SDK bêta, lisez le fichier readme dans le référentiel GitHub des SDK de chaque langue.
Politique de prise en charge des SDK Stripe
Les nouvelles fonctionnalités et corrections de bogues sont publiées sur la dernière version majeure d’un SDK. Si vous utilisez une ancienne version majeure du SDK, nous vous recommandons de passer à la version majeure la plus récente pour bénéficier de ces fonctionnalités et corrections de bogues. Les anciennes versions majeures du paquet restent disponibles, mais ne reçoivent plus aucune mise à jour.
Guides de migration
Nous fournissons des guides de migration pour vous aider à effectuer une mise à niveau à partir d’anciennes versions majeures de SDK. Vous les trouverez dans la section Wiki de nos référentiels SDK GitHub.
- Wiki du SDK Python
- Wiki du SDK .NET
- Wiki du SDK Java
- Wiki du SDK Go
- Wiki du SDK PHP/wiki
- Wiki du SDK Ruby/wiki
- Wiki du SDK Node.js