Everything I know about good API design

Most of what modern software engineers do involves APIs: public interfaces for communicating with a program, like this one from Twilio. I’ve spent a lot of time…

In the agentic AI era, well-designed CLIs matter more than ever - serving both Human Users and Autonomous Agents with precision and reliability.

➡️ Treat CLI output formats as stable API contracts
➡️ Prioritize adoption of the MCP protocol for agent integration from day one

📖 Read the #InfoQ article: https://bit.ly/45JRXyn

#SoftwareArchitecture #APIdesign #API

Guiding Principles of Great Web APIs https://buff.ly/0ZYymKZ

here's the slide deck for my #BSDC2025 talk. a great event in a beautiful part of the US.

#api360 #apiDesign

Stable APIs create a strong foundation for robust software. Discover strategies to preserve API stability and ensure smooth scalability and maintenance in our latest blog. #APIDesign #SoftwareDevelopment #CodeQuality
https://www.kdab.com/api-stability-to-change-or-not-to-change/
API Stability: Balancing Flexibility for Internal APIs with Reliability for External APIs | KDAB

Explore the delicate balance between API stability and flexibility. Learn when to evolve internal APIs for better maintainability and why external APIs require careful versioning and stability guarantees to protect users.

KDAB
MCP Servers with OAuth by Zach Silveira is free with a Leanpub Reader membership! Or you can buy it for $4.99! http://leanpub.com/creatingmcpserverswithoauth #ApiDesign
MCP Servers with OAuth

Leanpub

🗒️ Pssst. Kennen jullie onze API Design Rules Cheat Sheet al?

https://developer.overheid.nl/kennisbank/apis/api-design-rules/cheat-sheet

📌 Het geeft je een overzicht met de belangrijkste technische regels en best practices om te gebruiken tijdens het ontwerpen van een API middels een Open API Specification.

#apidesignrules #oas #apidesign

ADR Cheat Sheet | developer.overheid.nl

Het actuele en uitgebreide overzicht van de REST API Design Rules vind je hier: API Design Rules. Hieronder vind je echter een extract met de belangrijkste technische regels en best practices om te gebruiken tijdens het ontwerpen van een API.

Software Architecture and Design Practice Reference https://leanpub.com/b/software-architecture-dpr by Cesare Pautasso, Olaf Zimmermann, and Mirko Stocker is the featured bundle of ebooks 📚 on the Leanpub homepage! https://leanpub.com #Textbooks #SoftwareArchitecture #ApiDesign #SoftwareEngineering #SystemIntegration #WebDevelopment #books #ebooks pautasso@scholar.social stocker@mastodon.social
MCP Servers with OAuth by Zach Silveira is free with a Leanpub Reader membership! Or you can buy it for $4.99! http://leanpub.com/creatingmcpserverswithoauth #ApiDesign
MCP Servers with OAuth

Leanpub
Most RESTful APIs aren’t really RESTful

When talking about REST, it is worth reading the dissertation of Roy Thomas Fielding. The original paper that describes RESTful web, “Architectural Styles and the Design of Network-based Software Architectures” Roy T. Fielding (2000), introduces the Representational State Transfer (REST) architectural style as a framework for designing scalable, performant, and maintainable networked systems, particularly web services.

Florian Krämer
MCP Servers with OAuth by Zach Silveira is free with a Leanpub Reader membership! Or you can buy it for $4.99! http://leanpub.com/creatingmcpserverswithoauth #ApiDesign
MCP Servers with OAuth

Leanpub