# Mises à niveau de l'API Suivez l’évolution et les mises à niveau de l'API Stripe. > [Les événements légers](https://docs.stripe.com/event-destinations.md#thin-events) pour les ressources API v1 sont disponibles en version bêta privée. Vous pouvez les utiliser pour rationaliser les mises à niveau d’intégration sans modifier la configuration de votre webhook. Auparavant, les événements légers ne prenaient en charge que les ressources API v2. [En savoir plus et demander l’accès](https://docs.google.com/forms/d/e/1FAIpQLSeEkqzB02afvlklMkqwA6wsBH90eW8gxmc-hBOvqe2N6TRujQ/viewform?usp=dialog). La version de votre API contrôle le comportement de l’API et du webhook que vous voyez (par exemple, les paramètres que vous pouvez inclure dans les requêtes, les propriétés que vous voyez dans les réponses, etc.). Votre version est définie la première fois que vous effectuez une requête d’API. Chaque version majeure, comme [Acacia](https://docs.stripe.com/changelog/acacia.md), inclut des modifications qui ne sont pas rétrocompatibles avec les versions précédentes. La mise à niveau à une nouvelle version majeure peut nécessiter des mises à jour du code existant. Chaque version mensuelle inclut uniquement des modifications rétrocompatibles et porte le même nom que la dernière version majeure. Vous pouvez effectuer une mise à niveau à une nouvelle version mensuelle en toute sécurité sans altérer le code existant. Pour mettre à niveau votre version de l’API, procédez [comme suit](https://docs.stripe.com/upgrades.md#how-can-i-upgrade-my-api). Lorsqu’une [plateforme Connect](https://stripe.com/connect) effectue des requêtes au nom de comptes connectés sans préciser de version d’API, Stripe utilise toujours la version de l’API de la plateforme. Quelle que soit la version de l’API d’un compte connecté, les requêtes de la plateforme effectuées en son nom renvoient toujours des réponses correspondant à la version de l’API de la requête. ## Modifications rétrocompatibles Stripe considère que les modifications suivantes sont rétrocompatibles : - Ajout de nouvelles ressources d’API. - Ajout de nouveaux paramètres de requête facultatifs aux méthodes d’API existantes. - Ajout de nouvelles propriétés aux réponses d’API existantes. - Modification de l’ordre des propriétés dans les réponses de l’API existantes. - Modification de la longueur ou du format de chaînes opaques, comme des ID d’objets, des messages d’erreur et d’autres chaînes lisibles par des êtres humains. - Ces modifications incluent l’ajout ou la suppression de préfixes fixes (comme le préfixe `ch_` des ID de paiement). - Assurez-vous que votre intégration peut gérer les ID des objets générés par Stripe qui peuvent contenir jusqu’à 255 caractères. Par exemple, si vous utilisez MySQL, stockez les ID dans une colonne `VARCHAR(255) COLLATE utf8_bin` (la configuration `COLLATE` garantit que la casse sera prise en compte dans les recherches). - Ajout de nouveaux types d’événements. - Assurez-vous que votre écouteur de webhook gère de manière appropriée les types d’événements inconnus. ## Mettre à niveau la version de votre API Si vous utilisez une ancienne version de l’API, effectuez une mise à niveau à la dernière version pour bénéficier des nouvelles fonctionnalités. La mise à niveau de l’API a des conséquences sur les éléments suivants : - Les appels d’API que vous effectuez sans l’en-tête `Stripe-Version` : les paramètres que vous pouvez envoyer et la structure des objets renvoyés. - La structure des objets reçus avec des méthodes [Stripe.js](https://docs.stripe.com/payments/elements.md) comme [confirmCardPayment](https://docs.stripe.com/js.md#stripe-confirm-card-payment). - La structure des objets envoyés aux points de terminaison de votre webhook (Account et [Connect](https://docs.stripe.com/connect/webhooks.md)). Toutefois, si une version explicite a été définie pour le point de terminaison, il utilisera toujours cette version. - Les opérations automatisées de Billing effectuées par Stripe (par exemple, la génération d’une *facture* (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) pour une nouvelle période d’abonnement) utilisent la version de l’API par défaut de votre compte. Consultez le journal des modifications de l’API pour en savoir plus sur l’impact de votre version de l’API par défaut sur ces opérations. ### Afficher la version de votre API et la dernière mise à niveau disponible dans Workbench Consultez la [version de l’API utilisée par les dernières requêtes](https://docs.stripe.com/workbench/guides.md#view-api-versions) sur votre compte et la dernière mise à niveau disponible à partir de l’onglet [Aperçu](https://dashboard.stripe.com/workbench/overview) dans Workbench. Lors de la mise à niveau de l’API, assurez-vous de préciser dans votre code la version de l’API que vous intégrez plutôt que de vous appuyer sur la version de l’API par défaut de votre compte. Pour tester une version plus récente pour vos appels à l’API, définissez l’en-tête `Stripe-Version` (en mode production ou mode test). Découvrez comment gérer le contrôle de versions dans nos [trousses SDK côté serveur](https://docs.stripe.com/sdks.md#server-side-libraries). ### Mettez à niveau et testez vos webhooks Consultez notre guide sur [la gestion des versions de webhook](https://docs.stripe.com/webhooks/versioning.md). ### Effectuer la mise à niveau Lorsque vous êtes sûr que votre code peut gérer la dernière version de l’API, effectuez la mise à niveau avec Workbench : 1. Ouvrez l’onglet [Aperçu](https://dashboard.stripe.com/workbench/overview) dans Workbench. 1. Dans la section **Versions de l’API**, cliquez sur **Mise à niveau disponible**, qui sera visible si une version plus récente de l’API est disponible. 1. Vérifiez quelle version de l’API sera attribuée à votre compte, puis cliquez sur **Mettre à niveau**. Cette opération permet de basculer les appels à l’API qui ne contiennent pas l’en-tête `Stripe-Version` et change également la version utilisée pour rendre les objets envoyés à vos webhooks. > La forme des ressources dans les [événements récupérés de l’API](https://docs.stripe.com/api/events.md) est définie par la version de l’API par défaut de votre compte au moment où l’événement s’est produit. Si votre code récupère des événements créés lorsque la version de votre API par défaut était différente, il doit tenir compte de toute différence entre les versions d’événements. ### Revenir à votre version précédente de l’API Dans les 72 heures qui suivent la mise à niveau de l’API, vous pouvez revenir en toute sécurité à la version d’origine à partir de Workbench. Une fois cette restauration effectuée, les webhooks envoyés avec la nouvelle structure d’objet et ayant échoué sont relancés avec l’ancienne structure. ## Se tenir au courant Nous envoyons des informations sur les ajouts et modifications de l’API Stripe et des bibliothèques dans le Stripe Developer Digest. Abonnez-vous-y pour ne rien [manquer ](https://go.stripe.global/dev-digest) de ces évolutions. ## Versions de l’API > Cette section n’est plus mise à jour. Pour en savoir plus sur les mises à jour de l’API Stripe, consultez le nouveau [journal des modifications](https://docs.stripe.com/changelog.md). Vous trouverez ci-dessous toutes les [modifications importantes](https://docs.stripe.com/upgrades.md#breaking-change) apportées à l’API Stripe. Chaque date correspond à une nouvelle version de l’API Stripe. Si vous recherchez tous les ajouts et mises à jour de l’API, consultez le [journal des modifications](https://docs.stripe.com/changelog.md) de l’API. Pour en savoir plus sur les nouvelles versions des produits, consultez le [journal des modifications](https://stripe.com/blog/changelog) du produit.