sbensu: Breaking changes in JSON APIs

For an overall product development strategy, see How to avoid breaking APIs.When writing graphical user interfaces, the end user is a person. If the user interface changes overnight, the user might be surprised but they can adapt and react accordingly. Most software companies are used to changing their products often in various ways. API products don’t have this luxury.

sbensu: Breaking changes in JSON APIs Breaking changes in JSON APIs March 2023 For an overall product development strategy, see How to avoid breaking APIs . When writing graphical user interfaces, the end user is a person. If the user interface changes overnight, the user might be surprised but they can adapt and react accordingly. Most software companies are used to changing their products often in various ways. API products don’t have this luxury. APIs are used by programs which can’t adapt to change. So, whenever you change an API, the change should be backwards compatible so that the new A

related reading

• Everything I know about good API designseangoedecke.com
• Stripe Dot Devstripe.dev
• APIs All the Way Down - Not Boring by Packy McCormicknotboring.co
• Project Cambria: Translate your data with lensesinkandswitch.com
• How to (and how not to) design REST APIs · stickfigure/blog Wiki · GitHubgithub.com
• Shopify Editions | Winter '26shopify.com
• Errors | Stripe API Referencestripe.com
• Inside Stripe’s Engineering Culture: Part 2newsletter.pragmaticengineer.com
• Web Interface Guidelinesvercel.com
• Stripe’s payments APIs: The first 10 years | Stripe Dot Dev Blogstripe.com
• OpenAI Platformplatform.openai.com
• Write code that is easy to delete, not easy to... — programming is terribleprogrammingisterrible.com