Welcome to API Design Matters

On this site, I focus on RESTful web services and APIs, but many of the concepts apply to other API styles like AsyncAPI, GRPC, and GraphQL. Articles pull from my 13+ years experience designing RESTful APIs using OpenAPI, but include echos of designing traditional programming language interfaces and libraries over 30+ years of my professional career.

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 this site will often discuss the interplay of API Design and DX: how and why API Design Matters to DX.

API Design Matters is written by David Biesack.

I am in the process of moving my content off of Substack (https://apidesignmatters.substack.com) for reasons explained here.

Until I can migrate all my content, please refer to that archive for my earlier writing.

You can subscribe in the meantime if you'd like to stay up to date and receive emails when new content is published!