Dépréciation des API Shopify : l'édition 2021-04

Bienvenue dans une nouvelle édition de la dépréciation des API chez Shopify, où nous nous intéressons aux prochaines modifications qui entreront en vigueur pour toutes les versions prises en charge. Dans cette édition, nous reviendrons sur les changements qui ont été apportés à notre version de juillet 2020 et aborderons certains points essentiels pour les développeurs d'applications privées.

Informations importantes pour les applications privées

Au début de la pandémie de la COVID-19, nous avons décidé de repousser à une date indéfinie les dépréciations de versions d'API pour les applications privées. Les solutions pour ces applications sont hautement personnalisées et un responsable technique doit être averti des changements nécessaires, ce qui pouvait être difficile à cette période. Nous ne voulions pas demander aux marchands de gérer la migration de leurs applications tout en s'adaptant aux nouvelles exigences commerciales liées à la pandémie.

Maintenant que nous sommes tous plus ou moins accoutumés à cette nouvelle situation, nous souhaitons rétablir le même calendrier de versions pour toutes les applications. En abandonnant complètement les anciennes versions, Shopify peut supprimer les chemins de code obsolètes et ainsi proposer une plateforme plus performante à tous les utilisateurs.

Le 1er avril 2021, les applications privées n'auront plus accès aux versions non prises en charge de l'API (2019-04, 2019-07, 2019-10, 2020-01 et 2020-04). Les requêtes provenant d'applications privées et utilisant un comportement abandonné ne seront plus prises en charge et suivront désormais le même comportement que les applications publiques.

En savoir plus sur les changements critiques pour les applications privées

Vous êtes un développeur responsable d'une application privée ? Découvrez dans les autres articles de cette série la liste des changements critiques, dits « cassants », et des conseils pour les gérer :

• Dépréciations et versions des API chez Shopify : ce que vous devez savoir (en anglais)
• Dépréciation des API Shopify : l'édition 2020-10 (en anglais)
• Dépréciation des API Shopify : l'édition 2021-01

Nous vous recommandons également de consulter la page d'informations (en anglais) sur les applications privées dans la documentation pour les développeurs afin de préparer votre application aux changements à venir.

Consulter la page

Un rapide rappel sur le versioning

Avant de nous lancer dans les changements à venir, voici un récapitulatif du fonctionnement du versioning de l'API chez Shopify.

• Nous sortons une version tous les trimestres. Ces sorties ont généralement lieu le ou vers le 1er janvier, le 1er avril, le 2 juillet et le 1er octobre. Les versions sont nommées selon un format année-mois (par exemple 2021-01), ce qui permet de toujours identifier facilement le moment où la version est devenue stable, ainsi que de comparer les calendriers de plusieurs versions.
  
  
• Les applications effectuent des requêtes vers une version spécifique de l'API en la spécifiant dans l'URL de la requête. Bien que les API de Shopify évoluent en permanence, les applications peuvent être construites sur une version stable afin de garantir que le contrat de l'API reste constant. Gardez à l'esprit que cela signifie que toutes les fonctionnalités publiées après la version ciblée ne seront pas accessibles tant que vous n'aurez pas mis à jour l'URL de votre requête.
  
  
• Nous mettons continuellement de nouvelles fonctionnalités à disposition des marchands. Afin d'offrir ces fonctionnalités sans affecter les dernières API stables, nous utilisons des versions candidates. La version candidate est simplement la prochaine version de l'API, et peut être ciblée pour les requêtes utilisant le même format année-mois. Dans la version candidate, vous trouverez le dernier ensemble de fonctionnalités qui vient d'être publié. Cependant, comme elle est en constante évolution, vous devez éviter d'utiliser la version candidate pour l’utilisation quotidienne de l'API de votre application. Pour bénéficier à la fois de la stabilité et de l'accès aux dernières fonctionnalités, nous vous recommandons de conserver les requêtes quotidiennes de votre application dans une version stable, et de ne déplacer vers la version candidate que les appels spécifiques qui concernent des fonctionnalités récemment publiées.
  
  
• Les applications qui ne demandent pas une version spécifique obtiennent la version la plus ancienne prise en charge. Cela permet aux applications existantes de continuer à fonctionner lorsque nous lançons le versioning, sans avoir à faire de mise à jour avec les nouvelles URL. Ce concept s'applique également aux applications faisant appel à des versions qui ne sont plus prises en charge. Bien que chaque application bénéficie de ce mécanisme qui empêche toutes les requêtes d’afficher des erreurs après un changement de version, nous recommandons de cibler intentionnellement les versions récentes.
  
  
• Les versions sont prises en charge pendant un an. La suppression de la prise en charge des versions nous permet d'apporter les modifications nécessaires pour servir au mieux nos marchands et la plateforme Shopify sur le long terme. Si les versions sont prises en charge pendant un an, cela signifie cependant que les applications n'ont en fait que neuf mois pour adopter ces nouveaux changements et profiter des nouvelles fonctionnalités avant que l'ancien comportement ne soit plus disponible. Avec ce récapitulatif en tête, passons en revue les informations clés dont vous aurez besoin pour être prêt pour le 1er avril 2021.

Ce qui va se passer le 1er avril 2021

Le 1er avril 2021, les changements suivants entreront en vigueur sur nos API pour les applications publiques comme pour les applications privées :

• La version 2021-04 deviendra stable et prête à être utilisée.
• La version 2020-04 ne sera plus prise en charge.
• Les demandes obsolètes suite aux changements dans 2020-07 entraîneront le signalement de votre application. Pour minimiser l'impact sur les marchands, Shopify supprimera les applications signalées de l'App Store de Shopify et bloquera les nouvelles installations. Il est également possible que nous informions les marchands du fait que vos applications ne sont plus prises en charge.

Peu de temps après, à la date que nous aurons choisie :

• Les requêtes ne comportant pas de version API spécifiée seront renvoyées vers la version 2020-07.
• Les requêtes pour la version 2020-04 ne seront pas prises en compte sous cette version. Ces requêtes seront renvoyées vers la version 2020-07.
• Les webhooks fixés à 2020-04 seront renvoyés de la même manière.

Attention, la version 2020-07 de l'API, qui deviendra la version par défaut, comprend des changements cassants de l'API. Si votre application émet des requêtes qui ne sont pas prises en charge par la version 2020-07, vous devez faire en sorte de migrer ces requêtes avant le 1er avril 2021. Si vous ne le faites pas, les requêtes échoueront et l'application affichera des erreurs.

Voyons maintenant en détail les changements introduits dans la version 2020-07.

Changements à venir

Vous trouverez ci-dessous les changements introduits en 2020-07, qui deviendra la plus ancienne version prise en charge par Shopify au 1er avril.

1. Méthode d'allocation des réductions

Nous avons retravaillé les valeurs possibles des réductions pour lesquelles l'attribut target_selection est défini comme explicit. Ces réductions étaient auparavant appliquées à une seule rubrique et avaient une valeur one. Avec ce changement, les méthodes d’allocation incluront désormais uniquement each et across.

Nous avons effectué ce changement afin de simplifier la syntaxe des réductions, puisque les fonctionnalités one et across permettent toutes les deux de réduire le prix final d'un montant fixe.

Ce qu'il faut retenir : lorsque vous consulterez les réductions, vous verrez peut-être une valeur de méthode d'allocation across là où vous voyiez avant one.

2. Suppression de la ressource images de ProductVariant

Dans notre API administrateur GraphQL, le champ « images » de l'objet ProductVariant avait été marqué comme abandonné, car il avait été remplacé par le champ au nom plus pertinent « image ». Ce changement achève la dépréciation en supprimant entièrement le champ.

Ce qu'il faut retenir : utilisez désormais le champ « image » pour envoyer une requête sur l'image de ProductVariant dans GraphQL.

Préparez-vous pour le 1er avril 2021

Les ressources suivantes peuvent vous aider à vous tenir informé des changements apportés à la plateforme Shopify :

• Rapport sur la santé des API : ce rapport de santé par application est disponible dans le tableau de bord des partenaires et vous présente les modifications exactes de l'API qui vous concernent.
  
  
• E-mail : assurez-vous que l’adresse e-mail de votre développeur est à jour afin que nous puissions vous informer des changements à venir.
• En-têtes de dépréciation : dans votre application, l'en-tête X-Shopify-API-Deprecated-Reason est ajouté aux requêtes dépréciées qui ne seront plus prises en charge d’ici neuf mois.
  
  
• Journal des changements pour les développeurs : restez au courant des dernières modifications apportées aux API de Shopify et aux autres produits destinés aux développeurs.
  
  
• Point de terminaison pour les appels d'API dépréciés : les applications privées peuvent accéder aux informations relatives à la santé de leurs API via ce point de terminaison.
  
  
• Consultez les notes de la version 2021-04 pour connaître l'ensemble des nouvelles fonctionnalités, votre tableau de bord des partenaires pour savoir quels changements peuvent vous concerner.

Consultez les notes de la version 2021-04 pour connaître l'ensemble des nouvelles fonctionnalités, votre tableau de bord des partenaires pour savoir quels changements peuvent vous concerner.

---

Publié par Maud Leuenberger. Maud est la rédactrice en chef du blog français de Shopify.

Texte original par Alex Bradley. Traduction par Solenn Marchand.