News for hackers. Stuff that matters.
Re:How Shopify Manages API Versioning and Breaking Changes by keithwhor on Thursday December 19, 2019 @09:37AM (#21835229)
I think it’s the implied stability, especially for long-standing APIs. S3’s API is 2006-03-01 — meaning there haven’t been breaking changes in over 13 years. This creates a psychological contract with developers that nothing’s changing anytime soon.

The trade off is that AWS has some godawful APIs (DynamoDB has the least intuitive API I have ever worked with). But they’re stable.

If you go with a date-based approach and create a process + contract whereby you guarantee API stability and / or deprecation date, the developer always knows exactly how much time they have before an upgrade.

There are no comments on this comment yet.