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.


Below are the most recent posts in API Design Matters. Visit Archives for the full archive of all posts.