#APIDesignMatters

David Biesack (he/him)DavidBiesack@fosstodon.org
2025-11-17

API Design Matters is Moving!

If you have followed my API Design Matters substack... I'm moving to a new location: apidesignmatters.org

See my farewell post on substack: open.substack.com/pub/apidesig and follow apidesignmatters.org for new #APIDesignMatters content!

David Biesack (he/him)DavidBiesack@fosstodon.org
2025-04-23

Published today: "The API Team Mantra [200 Is Not OK]" in #APIDesignMatters where I delve into what I shared recently: "The mantra of a good API Program Manager/Product Manager/Developer Advocate: APIs should help you solve your problems. APIs should not be your problem." apidesignmatters.substack.com/
#API #APIs #APIGovernance #APIProductManagement

Info graphic with stylized text reading 

"APIs should help you solve your problems"
"APIs should not be your problem"
"API Design Matters" and 
"David Biesack"
David Biesack (he/him)DavidBiesack@fosstodon.org
2025-03-17

Next post in #APIDesignMatters -- continuing my API Design Patterns series: "From Here to There, from Where to Here"
Patterns for Web API Query Parameters", apidesignmatters.substack.com/

banner graphic with white text in two blue large blocks reading "From Here to There, from Where to Here", "Patterns for Web API Query Parameters", black text in a yellow block reading "API Design Matters" and teal text rotated 90 degrees in a black box reading "David Biesack"
David Biesack (he/him)DavidBiesack@fosstodon.org
2025-01-24

New in "API Design Matters": "Wherefore HATEOAS", my views and commentary on Hypermedia APIs. apidesignmatters.substack.com/
#APIDesignMatters #APIs #HATEOAS

Banner graphic reading "Wherefore HATEOAS" "API Design Matters" "David Biesack"
David Biesack (he/him)DavidBiesack@fosstodon.org
2024-09-20

New article on API Design patterns in #APIDesignMatters: Leave a Calling Card: Make API responses more self-descriptive with reference objects open.substack.com/pub/apidesig

Banner graphic reading "Leave a Calling Card" - "API Design Matters" - "David Biesack" with a patterned texture background.
David Biesack (he/him)DavidBiesack@fosstodon.org
2024-08-19

Validating API Requests - API design patterns for assisting clients validate API calls with server-side validation , #APIDesignMatters open.substack.com/pub/apidesig

Banner Graphic reading "Validating API Requests", "API Design Matters" and "David Biesack", with a greyscale background pattern
David Biesack (he/him)DavidBiesack@fosstodon.org
2024-07-11

Since removing the paid subscriber tier on #APIDesignMatters last month, this archive article is now free for all visitors:
We Talk "API" One Day apidesignmatters.substack.com/ :
I’m “going meta”. I’m not going to talk about how languages (like the OpenAPI Specification and JSON Schema) describe specific #API concepts and artifacts, but rather how we talk about APIs themselves. In other words, I want to explore the Ubiquitous Language of APIS.

David Biesack (he/him)DavidBiesack@fosstodon.org
2024-06-18

My first post in my API Design Patterns series on API Design Matters: I dissect the use (the good, bad, and ugly) of the CRUD pattern in API design: apidesignmatters.substack.com/ #APIDesignMatters #API

David Biesack (he/him)DavidBiesack@fosstodon.org
2024-04-12
Title slide from my "The Art of API Design" presentation, with an abstract dark black/grey background with geometric patterns
David Biesack (he/him)DavidBiesack@fosstodon.org
2024-04-02

In #APIDesignMatters, I say "Pet Store: Just Say No!" and introduce two new contenders to replace Pet Store as the canonical #API definition "example" for #OpenAPI. apidesignmatters.substack.com/

banner graphic reading "PET STORE", with a yellow card showing a hand holding a smaller sign that reads "SAY NO!"
David Biesack (he/him)DavidBiesack@fosstodon.org
2024-03-22

"The API Design Mind Game" --
When it comes to API puzzles, it's all in your head. My latest #APIDesignMatters post, apidesignmatters.substack.com/

Banner for "The API Design Mind Game" post, "API Design Matters" by David Biesack
David Biesack (he/him)DavidBiesack@fosstodon.org
2023-12-16
David Biesack (he/him)DavidBiesack@fosstodon.org
2023-12-01

Thank You Erik Wilde for having me back on your "Getting APIs to Work" Youtube channel and for highlighting my "API Design Matters" substack and my "Language of APIs" series. Next up is JSON Schema - the Language of API Data linkedin.com/feed/update/urn:l and youtube.com/watch?v=s9kVJvyBKj
#APIDesignMatters #TheLanguageOfAPIs #APIs

David Biesack (he/him)DavidBiesack@fosstodon.org
2023-11-07

Today, I begin a deeper dive into expressing API Security with OpenAPI, by exploring the notation of security schemes and security requirement objects, with some commentary on the tradeoffs between conciseness vs. consistency, and what can and cannot be expressed with OpenAPI when it comes to keeping your API secure. #TheLanguageOfAPIs #OpenAPI #APIs #APIDesignMatters open.substack.com/pub/apidesig

Banner image: The Language of API Security, The Language of API Design, AOPI Design Matters by David Biesack
David Biesack (he/him)DavidBiesack@fosstodon.org
2023-10-07

Some tips on update operations for #APIs : "Keep Me Updated, OK?", part of the #LanguageOfAPIDesign and #APIDesignMatters
apidesignmatters.substack.com/

Client Info

Server: https://mastodon.social
Version: 2025.07
Repository: https://github.com/cyevgeniy/lmst