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
• Project Cambria: Translate your data with lensesinkandswitch.com
• Semantic Versioning 2.0.0 | Semantic Versioningsemver.org
• The Elements of UI Engineering — overreactedoverreacted.io
• Write code that is easy to delete, not easy to... — programming is terribleprogrammingisterrible.com
• APIs All the Way Down - Not Boring by Packy McCormicknotboring.co
• Best practices for REST API design - Stack Overflowstackoverflow.blog
• How to (and how not to) design REST APIs · stickfigure/blog Wiki · GitHubgithub.com
• Web Interface Guidelinesvercel.com
• Why We Don’t Trust the Database With Authentication – Sturdy Statisticsblog.sturdystatistics.com
• Mistakes engineers make in large established codebasesseangoedecke.com
• Mediumjkebertz.medium.com