News for hackers. Stuff that matters.
Re:How Shopify Manages API Versioning and Breaking Changes by kenrose on Thursday December 19, 2019 @09:47AM (#21835307)
One challenge with date based is that it can make your API seem old if it’s really stable. For example, see PagerDuty’s v1 events API:

https://events.pagerduty.com/generic/2010-04-15/create_event...

Customers there would sometimes ask if that API was still relevant given its date is 9+ years old.

In Shopify’s case, where there are quarterly version bumps and deprecation over time, date based makes better sense.

There are no comments on this comment yet.