#apidesignmatters — Public Fediverse posts
Live and recent posts from across the Fediverse tagged #apidesignmatters, aggregated by home.social.
-
In #APIDesignMatters today, I discuss #Clarity and how Clarity in API design results in better APIs, better Developer Experience, better User Experience, and better Business Value.
-
In #APIDesignMatters today, I discuss #Clarity and how Clarity in API design results in better APIs, better Developer Experience, better User Experience, and better Business Value.
-
New post on #APIDesignMatters: "Form Follows Function" where I talk about how Form Follows Function as a means understanding API designs. Also making an appearance in today’s duality’s fray are the clashes of style over substance and syntax vs. semantics.
https://apidesignmatters.org/2026/06/21/form-follows-function.html
-
New post on #APIDesignMatters: "Form Follows Function" where I talk about how Form Follows Function as a means understanding API designs. Also making an appearance in today’s duality’s fray are the clashes of style over substance and syntax vs. semantics.
https://apidesignmatters.org/2026/06/21/form-follows-function.html
-
"Don't Go Off the Rails" - my latest post on #APIDesignMatters ; I discuss the value of API Governance. https://apidesignmatters.org/2026/05/13/dont-go-off-the-rails
-
"Don't Go Off the Rails" - my latest post on #APIDesignMatters ; I discuss the value of API Governance. https://apidesignmatters.org/2026/05/13/dont-go-off-the-rails
-
I have completed my migration of #APIDesignMatters off of Substack to my new domain: https://apidesignmatters.org . I've converted to Markdown and have hosted in an open-source GitHub repository at https://github.com/apidesignmatters/apidesignmatters.github.io and released it under the Creative Commons CC BY-NC 4.0 license (Attribution-NonCommercial 4.0 International).
I'll post future content at apidesignmatters.org and share on LinkedIn and here (follow me at @DavidBiesack ) using the hashtag #APIDesignMatters .
-
I have completed my migration of #APIDesignMatters off of Substack to my new domain: https://apidesignmatters.org . I've converted to Markdown and have hosted in an open-source GitHub repository at https://github.com/apidesignmatters/apidesignmatters.github.io and released it under the Creative Commons CC BY-NC 4.0 license (Attribution-NonCommercial 4.0 International).
I'll post future content at apidesignmatters.org and share on LinkedIn and here (follow me at @DavidBiesack ) using the hashtag #APIDesignMatters .
-
API Design Matters is Moving!
If you have followed my API Design Matters substack... I'm moving to a new location: https://apidesignmatters.org
See my farewell post on substack: https://open.substack.com/pub/apidesignmatters/p/api-design-matters-is-moving?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true and follow https://apidesignmatters.org for new #APIDesignMatters content!
-
API Design Matters is Moving!
If you have followed my API Design Matters substack... I'm moving to a new location: https://apidesignmatters.org
See my farewell post on substack: https://open.substack.com/pub/apidesignmatters/p/api-design-matters-is-moving?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true and follow https://apidesignmatters.org for new #APIDesignMatters content!
-
The Provenance of #APIDesignMatters. Who inspires you in the #API Space? https://open.substack.com/pub/apidesignmatters/p/provenance?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
The Provenance of #APIDesignMatters. Who inspires you in the #API Space? https://open.substack.com/pub/apidesignmatters/p/provenance?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
New post in "API Design Matters": API Design Antipattern: Leaky Abstractions
-
New post in "API Design Matters": API Design Antipattern: Leaky Abstractions
-
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." https://apidesignmatters.substack.com/p/the-api-team-mantra
#API #APIs #APIGovernance #APIProductManagement -
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." https://apidesignmatters.substack.com/p/the-api-team-mantra
#API #APIs #APIGovernance #APIProductManagement -
Next post in #APIDesignMatters -- continuing my API Design Patterns series: "From Here to There, from Where to Here"
Patterns for Web API Query Parameters", https://apidesignmatters.substack.com/p/from-here-to-there-from-where-to -
Next post in #APIDesignMatters -- continuing my API Design Patterns series: "From Here to There, from Where to Here"
Patterns for Web API Query Parameters", https://apidesignmatters.substack.com/p/from-here-to-there-from-where-to -
New in "API Design Matters": "Wherefore HATEOAS", my views and commentary on Hypermedia APIs. https://apidesignmatters.substack.com/p/wherefore-hateoas
#APIDesignMatters #APIs #HATEOAS -
New in "API Design Matters": "Wherefore HATEOAS", my views and commentary on Hypermedia APIs. https://apidesignmatters.substack.com/p/wherefore-hateoas
#APIDesignMatters #APIs #HATEOAS -
New article on API Design patterns in #APIDesignMatters: Leave a Calling Card: Make API responses more self-descriptive with reference objects https://open.substack.com/pub/apidesignmatters/p/leave-a-calling-card?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
New article on API Design patterns in #APIDesignMatters: Leave a Calling Card: Make API responses more self-descriptive with reference objects https://open.substack.com/pub/apidesignmatters/p/leave-a-calling-card?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
Validating API Requests - API design patterns for assisting clients validate API calls with server-side validation , #APIDesignMatters https://open.substack.com/pub/apidesignmatters/p/validating-api-requests?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
Validating API Requests - API design patterns for assisting clients validate API calls with server-side validation , #APIDesignMatters https://open.substack.com/pub/apidesignmatters/p/validating-api-requests?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
-
Since removing the paid subscriber tier on #APIDesignMatters last month, this archive article is now free for all visitors:
We Talk "API" One Day https://apidesignmatters.substack.com/p/we-talk-api-one-day :
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. -
Since removing the paid subscriber tier on #APIDesignMatters last month, this archive article is now free for all visitors:
We Talk "API" One Day https://apidesignmatters.substack.com/p/we-talk-api-one-day :
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. -
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: https://apidesignmatters.substack.com/p/oh-crud #APIDesignMatters #API
-
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: https://apidesignmatters.substack.com/p/oh-crud #APIDesignMatters #API
-
The Art of #API Design, my latest post in #APIDesignMatters: https://apidesignmatters.substack.com/p/the-art-of-api-design
-
The Art of #API Design, my latest post in #APIDesignMatters: https://apidesignmatters.substack.com/p/the-art-of-api-design
-
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. https://apidesignmatters.substack.com/p/pet-store-api-just-say-no
-
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. https://apidesignmatters.substack.com/p/pet-store-api-just-say-no
-
"The API Design Mind Game" --
When it comes to API puzzles, it's all in your head. My latest #APIDesignMatters post, https://apidesignmatters.substack.com/p/the-api-design-mind-game -
"The API Design Mind Game" --
When it comes to API puzzles, it's all in your head. My latest #APIDesignMatters post, https://apidesignmatters.substack.com/p/the-api-design-mind-game -
Please read and share my next "API Design Matters" post: "Improve the Security of Your API's Data"
https://open.substack.com/pub/apidesignmatters/p/improve-the-security-of-your-apis?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
#API #APIDesignMatters #TheLanguageOfAPIs -
Please read and share my next "API Design Matters" post: "Improve the Security of Your API's Data"
https://open.substack.com/pub/apidesignmatters/p/improve-the-security-of-your-apis?r=224cwh&utm_campaign=post&utm_medium=web&showWelcomeOnShare=true
#API #APIDesignMatters #TheLanguageOfAPIs -
For my #APIDesignMatters substack paid subscribers, "We Talk API One Day", https://open.substack.com/pub/apidesignmatters/p/we-talk-api-one-day?r=224cwh&utm_campaign=post&utm_medium=web&showWelcome=true , ("The Ubiquitous Language of #APIs")
-
For my #APIDesignMatters substack paid subscribers, "We Talk API One Day", https://open.substack.com/pub/apidesignmatters/p/we-talk-api-one-day?r=224cwh&utm_campaign=post&utm_medium=web&showWelcome=true , ("The Ubiquitous Language of #APIs")
-
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 https://www.linkedin.com/feed/update/urn:li:activity:7135885308293746688/ and https://www.youtube.com/watch?v=s9kVJvyBKjs
#APIDesignMatters #TheLanguageOfAPIs #APIs -
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 https://www.linkedin.com/feed/update/urn:li:activity:7135885308293746688/ and https://www.youtube.com/watch?v=s9kVJvyBKjs
#APIDesignMatters #TheLanguageOfAPIs #APIs -
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 https://open.substack.com/pub/apidesignmatters/p/understanding-the-language-of-api?r=224cwh&utm_campaign=post&utm_medium=web
-
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 https://open.substack.com/pub/apidesignmatters/p/understanding-the-language-of-api?r=224cwh&utm_campaign=post&utm_medium=web
-
Some tips on update operations for #APIs : "Keep Me Updated, OK?", part of the #LanguageOfAPIDesign and #APIDesignMatters
https://apidesignmatters.substack.com/p/keep-me-updated-ok -
Some tips on update operations for #APIs : "Keep Me Updated, OK?", part of the #LanguageOfAPIDesign and #APIDesignMatters
https://apidesignmatters.substack.com/p/keep-me-updated-ok -
Thanks to Erik Wilde for letting me join him on his Getting APIs to Work YouTube channel. I hope you enjoy it and will continue the conversation! #LanguageOfAPIDesign #APIDesignMatters #APIs https://www.linkedin.com/feed/update/urn:li:activity:7102266311681916928/
-
Thanks to Erik Wilde for letting me join him on his Getting APIs to Work YouTube channel. I hope you enjoy it and will continue the conversation! #LanguageOfAPIDesign #APIDesignMatters #APIs https://www.linkedin.com/feed/update/urn:li:activity:7102266311681916928/
-
"Getting Creative with OpenAPI" -- my next article in the #LanguageOfAPIDesign series in #APIDesignMatters, where I walk through many aspects of defining a resource creation operation in #OpenAPI https://apidesignmatters.substack.com/p/getting-creative-with-openapi #APIs
-
"Getting Creative with OpenAPI" -- my next article in the #LanguageOfAPIDesign series in #APIDesignMatters, where I walk through many aspects of defining a resource creation operation in #OpenAPI https://apidesignmatters.substack.com/p/getting-creative-with-openapi #APIs
-
Today, I present Part II of the Master JSON Schema's Subtleties article, imaginatively titled Master More JSON Schema’s Subtleties. Part of the #LanguageOfAPIDesign and #APIDesignMatters . Explore more use of unevaluatedProperties, JSON Merge Patch, and more. #APIs
https://apidesignmatters.substack.com/p/master-more-json-schemas-subtleties
-
Today, I present Part II of the Master JSON Schema's Subtleties article, imaginatively titled Master More JSON Schema’s Subtleties. Part of the #LanguageOfAPIDesign and #APIDesignMatters . Explore more use of unevaluatedProperties, JSON Merge Patch, and more. #APIs
https://apidesignmatters.substack.com/p/master-more-json-schemas-subtleties
-
Catch me on Erik Wilde's "Getting #APIs to Work" YouTube Channel: https://www.youtube.com/watch?v=J3-0P4kt9rg
(and LinkedIn Post https://www.linkedin.com/feed/update/urn:li:activity:7089489531409707008/ ) Subscribe to #APIDesignMatters at https://apidesignmatters.substack.com/ -
Catch me on Erik Wilde's "Getting #APIs to Work" YouTube Channel: https://www.youtube.com/watch?v=J3-0P4kt9rg
(and LinkedIn Post https://www.linkedin.com/feed/update/urn:li:activity:7089489531409707008/ ) Subscribe to #APIDesignMatters at https://apidesignmatters.substack.com/ -
Next up on #APIDesignMatters: Master JSON Schema's Subtleties: a post on the more subtle nuances of #JSONSchema as a language for designing #API data. Knowing these details will help you understand other APIs’ schemas and help you construct your own.
https://apidesignmatters.substack.com/p/master-json-schemas-subtleties
Enjoy, and please subscribe and share!
-
Next up on #APIDesignMatters: Master JSON Schema's Subtleties: a post on the more subtle nuances of #JSONSchema as a language for designing #API data. Knowing these details will help you understand other APIs’ schemas and help you construct your own.
https://apidesignmatters.substack.com/p/master-json-schemas-subtleties
Enjoy, and please subscribe and share!
-
Woot - The cool folks at #Stoplight invited me to their #API Intersections podcast, and it dropped today. We talked about API [First] Design, my #APIDesignMatters substack https://apidesignmatters.substack.com/ and more.
Thanks for the opportunity Jason Harmon and team! -
Woot - The cool folks at #Stoplight invited me to their #API Intersections podcast, and it dropped today. We talked about API [First] Design, my #APIDesignMatters substack https://apidesignmatters.substack.com/ and more.
Thanks for the opportunity Jason Harmon and team!