API Deprecation at Shopify: 2021-10 Edition

TyW
Community Manager
Community Manager
413 40 1107

Cross-posted from the Shopify Partners blog

shopify-api-release-october-2021.jpeg

Welcome to another edition of API deprecations at Shopify, where we dive into the breaking changes coming into effect for all supported versions. In this edition, we'll review the breaking changes in the 2021-01 API version, the oldest supported version as of October 1, 2021. This includes vital information for developers of private apps. Let's take a look.

A quick refresher on versioning

Before we dive into the changes headed your way, let's revisit how API versioning at Shopify works.

  • We release a version every quarter. These releases typically happen on or around January 1, April 1, July 1, and October 1. Versions are named in a year-month format (e.g. 2021-01), ensuring that it will always be easy to identify the time the version became stable, as well as compare the timelines of multiple versions.

  • Apps make requests to a specific version of the API by specifying it in the request URL. While the Shopify APIs continuously evolve, apps can be built on a stable version to ensure that the API contract remains constant. Keep in mind this means that any features released after your targeted version won't be accessible until you update your request URL.

  • We release features to merchants continuously. To ship features without affecting the latest stable APIs, we use release candidates. The release candidate is simply the next API version, and can be targeted for requests using the same year-month format. In the release candidate, you'll find the latest set of features that have just been released. However, since it's continuously evolving, you should avoid using the release candidate for your app's general everyday consumption of the API. To have both the benefit of stability and access to the latest features, we recommend keeping your app's everyday requests on a stable version, and only moving specific calls that deal with newly released features to the release candidate.

  • Apps that do not request a specific version are served the oldest supported version. This allowed existing apps to continue functioning when we shipped versioning, without having to update to the new URLs. This concept also applies to apps explicitly calling versions that are no longer supported. While every app will benefit from this mechanism preventing all of their requests from erroring out after a version switch, we recommend targeting recent releases intentionally.

  • Versions are supported for one year. Removing support for versions allows us to stay agile and make the changes needed to best serve our merchants and the Shopify platform for the long term. While versions are supported for one year, this means that apps actually only have nine months to adopt these new changes and take advantage of new features before the old behavior is no longer available.

With this refresher at the top of our mind, let's review the key information you'll need to be ready for October 1, 2021.

To learn more about what’s happening on October 1 check out the rest of the blog post on the Shopify Partners Blog and if you have any questions leave a comment!

 

TyW | Online Community Manager @ Shopify 
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Mark it as an Accepted Solution
 - To learn more visit the Shopify Help Center or the Shopify Blog

Replies 0 (0)