Welcome to API Design Matters, where I explore API Design and Developer Experience matters large and small, topics around building and running API programs… that is, why API Design Matters.
In API Design Matters (ADM), I will focus on RESTful web services, but many of the concepts apply to other API styles like AsyncIO, GRPC, and GraphQL. Articles will pull from my 12 years experience designing RESTful APIs using OpenAPI, but include echos of designing traditional programming language interfaces and libraries over 30+ years of my career.
API Design Matters is created and authored by David Biesack.
API Design is truly an art, and while ChatGPT can spit out basic APIs, there is still much to be said for well-crafted consistent APIs designed in a broader context, with the consumer and Developer Experience in mind.
A good (or great) Developer Experience (DX) is an important aspect of API design, and ADM will often discuss the interplay of API design and DX: how and why API Design matters to DX.
I will begin API Design Matters with an extensive series on The Language of API Design. This series will focus on the API First process to complete learning projects with the OpenAPI 3 Specification-why API Design with OpenAPI matters.
To view all articles in API Design Matters, please visit the Archive.
Enough about me. I hope to hear from you - what topics of API Design are top of mind? How do you approach the design process? Let’s have a conversation.
Join the discussion
You can also find me on fosstodon.org/@DavidBiesack (no ɹǝʇʇᴉʍʇ, thank you).