what am I working on when i'm not writing new material for "AI-Driven API Design" w/ O'Reilly?
I continue to run experiments to expand the functionality of my GRAIL autonomous ecosystem.
here's a peek at a possible future for my current CLI environment.
#api360 #apiDesign #genAI
I continue to run experiments to expand the functionality of my GRAIL autonomous ecosystem.
here's a peek at a possible future for my current CLI environment.
#api360 #apiDesign #genAI
September 23, 2026 at 4:30 AM
what am I working on when i'm not writing new material for "AI-Driven API Design" w/ O'Reilly?
I continue to run experiments to expand the functionality of my GRAIL autonomous ecosystem.
here's a peek at a possible future for my current CLI environment.
#api360 #apiDesign #genAI
I continue to run experiments to expand the functionality of my GRAIL autonomous ecosystem.
here's a peek at a possible future for my current CLI environment.
#api360 #apiDesign #genAI
💻 I’ve written a guide on API Design for Speakeasy which is almost everything I know about designing an API from scratch. Basic theory of everything, pros and cons of various standards, pitfalls to watch out for, and best practices to stick to. #ApiDesign www.speakeasy.com/api-design
Index
www.speakeasy.com
December 31, 2024 at 11:01 AM
💻 I’ve written a guide on API Design for Speakeasy which is almost everything I know about designing an API from scratch. Basic theory of everything, pros and cons of various standards, pitfalls to watch out for, and best practices to stick to. #ApiDesign www.speakeasy.com/api-design
Guiding Principles of Great Web APIs buff.ly/0ZYymKZ
here's the slide deck for my #BSDC2025 talk. a great event in a beautiful part of the US.
#api360 #apiDesign
here's the slide deck for my #BSDC2025 talk. a great event in a beautiful part of the US.
#api360 #apiDesign
August 3, 2025 at 12:16 AM
Guiding Principles of Great Web APIs buff.ly/0ZYymKZ
here's the slide deck for my #BSDC2025 talk. a great event in a beautiful part of the US.
#api360 #apiDesign
here's the slide deck for my #BSDC2025 talk. a great event in a beautiful part of the US.
#api360 #apiDesign
Spec-First or Code-First? Choosing Your OpenAPI Strategy with Quarkus vs. Spring buff.ly/MkoXqSR
#Java #Quarkus #APIDesign #OpenAPI
#Java #Quarkus #APIDesign #OpenAPI
March 31, 2025 at 6:18 AM
Spec-First or Code-First? Choosing Your OpenAPI Strategy with Quarkus vs. Spring buff.ly/MkoXqSR
#Java #Quarkus #APIDesign #OpenAPI
#Java #Quarkus #APIDesign #OpenAPI
In Spring 5, HttpMethod became a problem.
In Spring 6, we could finally fix it.
New blog post on enums, backward compatibility, and quiet corrections:
poutsma-principles.com/blog/2025/05...
#Spring #Java #APIDesign #BackwardCompatibility
In Spring 6, we could finally fix it.
New blog post on enums, backward compatibility, and quiet corrections:
poutsma-principles.com/blog/2025/05...
#Spring #Java #APIDesign #BackwardCompatibility
When Fixing a Mistake Takes Five Years: the HttpMethod enum · Poutsma Principles
poutsma-principles.com
May 8, 2025 at 10:36 AM
In Spring 5, HttpMethod became a problem.
In Spring 6, we could finally fix it.
New blog post on enums, backward compatibility, and quiet corrections:
poutsma-principles.com/blog/2025/05...
#Spring #Java #APIDesign #BackwardCompatibility
In Spring 6, we could finally fix it.
New blog post on enums, backward compatibility, and quiet corrections:
poutsma-principles.com/blog/2025/05...
#Spring #Java #APIDesign #BackwardCompatibility
Ontology, Taxonomy, Choreography buff.ly/XQjeLLD
The best APIs have a certain feel to them. They’re easy to navigate, quick to understand, and surprisingly hard to misuse.
#api360 #apiDesign
The best APIs have a certain feel to them. They’re easy to navigate, quick to understand, and surprisingly hard to misuse.
#api360 #apiDesign
Ontology, Taxonomy, Choreography
The Forgotten Foundation of APIs
mamund.substack.com
August 25, 2025 at 2:15 PM
Ontology, Taxonomy, Choreography buff.ly/XQjeLLD
The best APIs have a certain feel to them. They’re easy to navigate, quick to understand, and surprisingly hard to misuse.
#api360 #apiDesign
The best APIs have a certain feel to them. They’re easy to navigate, quick to understand, and surprisingly hard to misuse.
#api360 #apiDesign
Finally checking #Codemotion Madrid off my wishlist! 🇪🇸✅ Today, I’m taking the stage to talk about API design, architecture patterns, and development with #Java and #JakartaEE. Really excited for this one!
#APIdesign #Architecture
#APIdesign #Architecture
April 20, 2026 at 10:46 AM
Finally checking #Codemotion Madrid off my wishlist! 🇪🇸✅ Today, I’m taking the stage to talk about API design, architecture patterns, and development with #Java and #JakartaEE. Really excited for this one!
#APIdesign #Architecture
#APIdesign #Architecture
It's been a while, but I just wrote a blog post where I draw a comparison between cross-platform UIs and polyglot APIs.
#polyglot #Java #Kotlin #APIDesign
#polyglot #Java #Kotlin #APIDesign
From Look and Feel to Idioms and Style · Poutsma Principles
poutsma-principles.com
September 5, 2025 at 1:34 PM
It's been a while, but I just wrote a blog post where I draw a comparison between cross-platform UIs and polyglot APIs.
#polyglot #Java #Kotlin #APIDesign
#polyglot #Java #Kotlin #APIDesign
New post: Fluent Internals
Part 4 of Crafting Fluent APIs dives into the type design behind RestClient: self-bounded generics, fluent states, and how the API stays clean on the surface.
#Java #Spring #APIDesign #FluentAPI #tech
Part 4 of Crafting Fluent APIs dives into the type design behind RestClient: self-bounded generics, fluent states, and how the API stays clean on the surface.
#Java #Spring #APIDesign #FluentAPI #tech
Fluent Internals · Poutsma Principles
poutsma-principles.com
June 3, 2025 at 10:16 AM
New post: Fluent Internals
Part 4 of Crafting Fluent APIs dives into the type design behind RestClient: self-bounded generics, fluent states, and how the API stays clean on the surface.
#Java #Spring #APIDesign #FluentAPI #tech
Part 4 of Crafting Fluent APIs dives into the type design behind RestClient: self-bounded generics, fluent states, and how the API stays clean on the surface.
#Java #Spring #APIDesign #FluentAPI #tech
Still a few seats available for my "Making Your APIs AI-Ready" live materclass at #apiDays Paris
Register for a 25% discount with MIKEMASTERCLASS
Hope to see you there!
b.mamund.com/4rjYVUO
#apiDesign #genAI
Register for a 25% discount with MIKEMASTERCLASS
Hope to see you there!
b.mamund.com/4rjYVUO
#apiDesign #genAI
December 1, 2025 at 12:01 PM
Still a few seats available for my "Making Your APIs AI-Ready" live materclass at #apiDays Paris
Register for a 25% discount with MIKEMASTERCLASS
Hope to see you there!
b.mamund.com/4rjYVUO
#apiDesign #genAI
Register for a 25% discount with MIKEMASTERCLASS
Hope to see you there!
b.mamund.com/4rjYVUO
#apiDesign #genAI
Api Versioning - A deep dive | by Irina Scurtu
buff.ly/irzIL6n
#apis #apidesign #programming #versioning
buff.ly/irzIL6n
#apis #apidesign #programming #versioning
Api Versioning - A deep dive
buff.ly
December 22, 2025 at 8:00 PM
Api Versioning - A deep dive | by Irina Scurtu
buff.ly/irzIL6n
#apis #apidesign #programming #versioning
buff.ly/irzIL6n
#apis #apidesign #programming #versioning
Why does Spring have multiple ways to specify URLs in its HTTP clients? It is not just API sugar—it is a design principle: use types to signal when data is correct.
New blog post on URLs, encoding, and avoiding stringly code.
#Spring #Java #APIDesign #tech
New blog post on URLs, encoding, and avoiding stringly code.
#Spring #Java #APIDesign #tech
Why Are There So Many URI Methods? · Poutsma Principles
poutsma-principles.com
April 23, 2025 at 12:37 PM
Why does Spring have multiple ways to specify URLs in its HTTP clients? It is not just API sugar—it is a design principle: use types to signal when data is correct.
New blog post on URLs, encoding, and avoiding stringly code.
#Spring #Java #APIDesign #tech
New blog post on URLs, encoding, and avoiding stringly code.
#Spring #Java #APIDesign #tech
The Web Is About to Get a Second Door medium.com/p/the-web-is...
#WebMCP, #AIAgents, #WebDevelopment, #LLM, #Agent #Architecture, #AgenticAI, #APIDesign, #Developer #Tools, #W3CStandards, #TokenOptimization, #AIMemory, #SemanticSearch
#WebMCP, #AIAgents, #WebDevelopment, #LLM, #Agent #Architecture, #AgenticAI, #APIDesign, #Developer #Tools, #W3CStandards, #TokenOptimization, #AIMemory, #SemanticSearch
The Web Is About to Get a Second Door
And most websites aren’t ready for it or even aware it's already happening.
medium.com
May 23, 2026 at 2:54 AM
The Web Is About to Get a Second Door medium.com/p/the-web-is...
#WebMCP, #AIAgents, #WebDevelopment, #LLM, #Agent #Architecture, #AgenticAI, #APIDesign, #Developer #Tools, #W3CStandards, #TokenOptimization, #AIMemory, #SemanticSearch
#WebMCP, #AIAgents, #WebDevelopment, #LLM, #Agent #Architecture, #AgenticAI, #APIDesign, #Developer #Tools, #W3CStandards, #TokenOptimization, #AIMemory, #SemanticSearch
rate limiting is one of those things every API needs but half implement wrong. fixed window leaks at the boundary. sliding window is better. token bucket handles bursts best. return 429 with Retry-After — that one header saves your consumers so much pain. #apidesign #developer #programming
May 19, 2026 at 11:44 PM
rate limiting is one of those things every API needs but half implement wrong. fixed window leaks at the boundary. sliding window is better. token bucket handles bursts best. return 429 with Retry-After — that one header saves your consumers so much pain. #apidesign #developer #programming
max_tokens is a guillotine, not a hint
Generation stops dead at the limit, mid-sentence, and stop_reason tells you it happened.
#CCAOF #ClaudeAPI #LLM #APIDesign
Full CCAO-F explanation, free: https://navyduck.com/anthropic/ccao-f/q054-output-tokens-limit
Generation stops dead at the limit, mid-sentence, and stop_reason tells you it happened.
#CCAOF #ClaudeAPI #LLM #APIDesign
Full CCAO-F explanation, free: https://navyduck.com/anthropic/ccao-f/q054-output-tokens-limit
September 26, 2026 at 5:00 PM
max_tokens is a guillotine, not a hint
Generation stops dead at the limit, mid-sentence, and stop_reason tells you it happened.
#CCAOF #ClaudeAPI #LLM #APIDesign
Full CCAO-F explanation, free: https://navyduck.com/anthropic/ccao-f/q054-output-tokens-limit
Generation stops dead at the limit, mid-sentence, and stop_reason tells you it happened.
#CCAOF #ClaudeAPI #LLM #APIDesign
Full CCAO-F explanation, free: https://navyduck.com/anthropic/ccao-f/q054-output-tokens-limit
New post: Responding to Real Usage
In Part 3 of Crafting Fluent APIs, I share how a conference demo led to a last-minute fix in WebClient's fluent API. Watch how people use your API, then improve it.
#Java #Spring #APIDesign #FluentAPI #tech
In Part 3 of Crafting Fluent APIs, I share how a conference demo led to a last-minute fix in WebClient's fluent API. Watch how people use your API, then improve it.
#Java #Spring #APIDesign #FluentAPI #tech
Responding to Real Usage · Poutsma Principles
poutsma-principles.com
May 28, 2025 at 11:02 AM
New post: Responding to Real Usage
In Part 3 of Crafting Fluent APIs, I share how a conference demo led to a last-minute fix in WebClient's fluent API. Watch how people use your API, then improve it.
#Java #Spring #APIDesign #FluentAPI #tech
In Part 3 of Crafting Fluent APIs, I share how a conference demo led to a last-minute fix in WebClient's fluent API. Watch how people use your API, then improve it.
#Java #Spring #APIDesign #FluentAPI #tech
New post: Making Your API Feel Like Home
If your API looks & feels like the rest of the ecosystem, it is easier to learn and harder to misuse.
#Java #SpringFramework #APIDesign #tech
If your API looks & feels like the rest of the ecosystem, it is easier to learn and harder to misuse.
#Java #SpringFramework #APIDesign #tech
Making Your API Feel Like Home · Poutsma Principles
poutsma-principles.com
June 11, 2025 at 6:56 AM
New post: Making Your API Feel Like Home
If your API looks & feels like the rest of the ecosystem, it is easier to learn and harder to misuse.
#Java #SpringFramework #APIDesign #tech
If your API looks & feels like the rest of the ecosystem, it is easier to learn and harder to misuse.
#Java #SpringFramework #APIDesign #tech
Cursor pagination is easy.
Until search shows up.
Until users scroll back.
Until someone tampers with your cursors.
A deep dive into search + infinite scroll done right with Quarkus, encrypted cursors, and PostgreSQL full-text search.
🔗 buff.ly/RTqD3AT
#Java #Quarkus #Backend #APIDesign
Until search shows up.
Until users scroll back.
Until someone tampers with your cursors.
A deep dive into search + infinite scroll done right with Quarkus, encrypted cursors, and PostgreSQL full-text search.
🔗 buff.ly/RTqD3AT
#Java #Quarkus #Backend #APIDesign
January 29, 2026 at 7:15 AM
Cursor pagination is easy.
Until search shows up.
Until users scroll back.
Until someone tampers with your cursors.
A deep dive into search + infinite scroll done right with Quarkus, encrypted cursors, and PostgreSQL full-text search.
🔗 buff.ly/RTqD3AT
#Java #Quarkus #Backend #APIDesign
Until search shows up.
Until users scroll back.
Until someone tampers with your cursors.
A deep dive into search + infinite scroll done right with Quarkus, encrypted cursors, and PostgreSQL full-text search.
🔗 buff.ly/RTqD3AT
#Java #Quarkus #Backend #APIDesign
Design and Reality: Essays on Software Design leanpub.com/design-and-r... by Rebecca Wirfs-Brock and Mathias Verraes is the featured book on the Leanpub homepage! leanpub.com #BusinessAndManagement #SoftwareArchitecture #Software #SoftwareEngineering #ApiDesign
Find it on Leanpub!
Find it on Leanpub!
October 29, 2025 at 8:45 PM
Design and Reality: Essays on Software Design leanpub.com/design-and-r... by Rebecca Wirfs-Brock and Mathias Verraes is the featured book on the Leanpub homepage! leanpub.com #BusinessAndManagement #SoftwareArchitecture #Software #SoftwareEngineering #ApiDesign
Find it on Leanpub!
Find it on Leanpub!
🎓 La certification du MOOC Naoplay « Design d’API RESTful » est maintenant ouverte !
Validez vos acquis et d’obtenez un badge Accredible, partageable sur LinkedIn.
🎟️ Offre de lancement : –15 % jusqu’à dimanche (code : APIREST15)
👉 www.naoplay.fr/expertise/mo...
#API #Certification #APIDesign
Validez vos acquis et d’obtenez un badge Accredible, partageable sur LinkedIn.
🎟️ Offre de lancement : –15 % jusqu’à dimanche (code : APIREST15)
👉 www.naoplay.fr/expertise/mo...
#API #Certification #APIDesign
November 4, 2025 at 3:07 PM
🎓 La certification du MOOC Naoplay « Design d’API RESTful » est maintenant ouverte !
Validez vos acquis et d’obtenez un badge Accredible, partageable sur LinkedIn.
🎟️ Offre de lancement : –15 % jusqu’à dimanche (code : APIREST15)
👉 www.naoplay.fr/expertise/mo...
#API #Certification #APIDesign
Validez vos acquis et d’obtenez un badge Accredible, partageable sur LinkedIn.
🎟️ Offre de lancement : –15 % jusqu’à dimanche (code : APIREST15)
👉 www.naoplay.fr/expertise/mo...
#API #Certification #APIDesign
New post: What's in a parameter name?
Frameworks like Spring and Embabel rely on parameter names as a way to implement Convention over Configuration. But in Java and Kotlin, those names are not always available.
I explain the details in this post
#Java #Kotlin #APIDesign #SpringFramework #Embabel
Frameworks like Spring and Embabel rely on parameter names as a way to implement Convention over Configuration. But in Java and Kotlin, those names are not always available.
I explain the details in this post
#Java #Kotlin #APIDesign #SpringFramework #Embabel
What's in a parameter name? · Poutsma Principles
poutsma-principles.com
September 25, 2025 at 12:05 PM
New post: What's in a parameter name?
Frameworks like Spring and Embabel rely on parameter names as a way to implement Convention over Configuration. But in Java and Kotlin, those names are not always available.
I explain the details in this post
#Java #Kotlin #APIDesign #SpringFramework #Embabel
Frameworks like Spring and Embabel rely on parameter names as a way to implement Convention over Configuration. But in Java and Kotlin, those names are not always available.
I explain the details in this post
#Java #Kotlin #APIDesign #SpringFramework #Embabel
New blog post: Designing for Short Completion Menus
Code completion is how developers explore your API. Fewer, more focused options lead to better usability. A look at fluent API design using RestTemplate vs RestClient.
#Java #Spring #APIDesign #tech
Code completion is how developers explore your API. Fewer, more focused options lead to better usability. A look at fluent API design using RestTemplate vs RestClient.
#Java #Spring #APIDesign #tech
Designing for Short Completion Menus · Poutsma Principles
poutsma-principles.com
May 15, 2025 at 8:24 AM
New blog post: Designing for Short Completion Menus
Code completion is how developers explore your API. Fewer, more focused options lead to better usability. A look at fluent API design using RestTemplate vs RestClient.
#Java #Spring #APIDesign #tech
Code completion is how developers explore your API. Fewer, more focused options lead to better usability. A look at fluent API design using RestTemplate vs RestClient.
#Java #Spring #APIDesign #tech
New blog post: The Origin of the Poutsma Principle.
It started as an inside joke at a SpringSource meeting—but the idea stuck: if an API is hard to understand, the design might need work.
#Java #Spring #APIDesign #tech
It started as an inside joke at a SpringSource meeting—but the idea stuck: if an API is hard to understand, the design might need work.
#Java #Spring #APIDesign #tech
The Origin of the “Poutsma Principle” · Poutsma Principles
poutsma-principles.com
April 15, 2025 at 10:41 AM
New blog post: The Origin of the Poutsma Principle.
It started as an inside joke at a SpringSource meeting—but the idea stuck: if an API is hard to understand, the design might need work.
#Java #Spring #APIDesign #tech
It started as an inside joke at a SpringSource meeting—but the idea stuck: if an API is hard to understand, the design might need work.
#Java #Spring #APIDesign #tech
6 Common API Architecture Styles
#APIDesign
#softwareArchitecture
Follow
@navneet066.bsky.social
and www.linkedin.com/in/ninadurann for more such contents.
#APIDesign
#softwareArchitecture
Follow
@navneet066.bsky.social
and www.linkedin.com/in/ninadurann for more such contents.
November 21, 2024 at 9:41 AM
6 Common API Architecture Styles
#APIDesign
#softwareArchitecture
Follow
@navneet066.bsky.social
and www.linkedin.com/in/ninadurann for more such contents.
#APIDesign
#softwareArchitecture
Follow
@navneet066.bsky.social
and www.linkedin.com/in/ninadurann for more such contents.
That's what happens when you stop building everything yourself and start building platforms. You create interfaces. You remove bottlenecks. You win.
#scrum #agile #dependencymanagement #platformbusinessmodel #apidesign #b2b #softwaredevelopment #devops #jira #confluence (25/25)
#scrum #agile #dependencymanagement #platformbusinessmodel #apidesign #b2b #softwaredevelopment #devops #jira #confluence (25/25)
June 8, 2026 at 12:40 PM
That's what happens when you stop building everything yourself and start building platforms. You create interfaces. You remove bottlenecks. You win.
#scrum #agile #dependencymanagement #platformbusinessmodel #apidesign #b2b #softwaredevelopment #devops #jira #confluence (25/25)
#scrum #agile #dependencymanagement #platformbusinessmodel #apidesign #b2b #softwaredevelopment #devops #jira #confluence (25/25)