Design First, AI Never
In the age of vibe-coding, how can we convince teams to invest in design before building APIs? Also in this newsletter: OpenAPI 3.3, Reddit's microservices architecture, an update to Speakeasy for OpenApi 3.2.0, and more!
What a whirlwind of a year. AI has been pumped into everything, and the constant marketing push informs me weekly that my job is no longer needed.
I have been searching for the right way to articulate the importance of good API design in the age of AI, and this post from Oxide hit close to the mark for me. LLMs are bad writers, and involving them early in the process can taint your output. Circling back to your APIs, you should focus on designing and writing good APIs flows yourself; use LLMs for review, not for design.
As the year comes to an end, this will be the last newsletter. We're back on the 15th of January. From the whole team at APIs You Won't Hate, have an amazing Christmas Holiday and a fantastic New Year. See you in 2026!
-- Alexander, Phil and Mike
The fastest way to build production-ready MCP servers
Gram by Speakeasy: turn your API platform into an AI platform. Create tools from OpenAPI, curate into custom toolsets, and deploy hosted MCP servers
Get started todayThe API Roundup
API News, links, and tools from around the web
OpenAPI 3.3
With OpenAPI 3.2 out in the wild, bolstering a substantial set of new features, attention is turning to version 3.3. If you're keen to get involved or learn what the OpenAPI team is thinking for version 3.3, check out their discussion in the GitHub repo.
OpenAPI 3.2 is here
Is this your first time hearing about OpenAPI 3.2? If so, where have you been living, under a rock? If you want a complete lowdown on all the features, check out this great post from Quobix (Dave Shanley). Honestly, I love the excitement that comes through in his writing for the new version.
OpenAPI.NET: The Biggest Update Ever
A few issues ago, I mentioned that OpenAPI.Net would receive OpenAPI V3.2 support in OpenAPI.Net V3. However, I was selling them short; they also added new OpenAPI features to OpenAPI.Net v2. (Wow, every time I re-read that sentence, my tongue ties in knots 😂) The short version is that V2 now supports the OpenAPI spec 3.1, and V3 supports 3.2. Check out the post for all the new supported features.
State of URL parsing performance in 2025
The author of cURL recently questioned the performance comparisons of Ada's URL parser. Yagix Nizipli jumped in and broke down the difference between cURL and Ada. In short, Ada delivers significant performance gains when parsing URLs, but we were not comparing apples to apples because Ada and cURL follow different specifications. Worth a read.
Gin is a very bad software library
If you're not familiar with it, Gin is one of the many Go web frameworks used for APIs, full-stack web applications, and more. However, Efron Licht does not like Gin and comes to the table with a whole heap of reasons why. It's a long blog post to summarise, but he gives solid reasons why you might not need Gin. A good read, regardless of whether you love or hate it.
Modernising Reddit's Comment Backend Infrastructure
Reddit discusses migrating its read and write endpoints from a Python monolith to Go microservices. While the read endpoints were relatively easy to migrate by comparing responses, the write endpoints were more complex. A solid approach if you ever have to migrate endpoints to another system.
How to make your API a catalyst for growth
A more commercial-focused post on how to get the most out of your API for you and your business. How can an API win you more customers and deals while driving awareness of your organisation? It's time to learn how your API can grow your business.
APIs You Won't Hate
Articles written and shared in our free Slack community.
Zero-Downtime Migration from Laravel Vapor to Laravel Cloud
Stuck on Laravel Vapor and dreaming of moving to Laravel Cloud? Phil has you covered with a handy guide to migrating without breaking anything. Open your favourite code editor and get ready to migrate and take advantage of Laravel Cloud's functionality.
From our Community
Articles written and shared in our free Slack community.
Speakeasy OpenAPI 3.2.0 Support
Tristan from Speakeasy reached out to our Slack channel last week to let us know they have added support for OpenAPI 3.2 in their parsing library and CLI tool. Get ready to update Speakeasy.
Support APIs You Won't Hate
When you become an member, you'll get access to members-only content while directly supporting our work. Your support helps us to keep making resources for the API community.
Become a member todayThanks so much to our members: Kin L, Juxt, Alex R, Nolan S, Frank, Bill, James D, Rich, Ryan T, Umair, Abdelhadi, and Brandon. Your support means the world to us!
✌️ Until next time,
Alexander, Phil & Mike
