New Year, New APIs
In this edition of the newsletter: The Go Developer Survey, tools for working with overlays, Scalar's OpenAPI Parser, and OpenAPI Arrazo in Go!
APIs have never been more essential, thanks to the ever-increasing usage of LLMs and AI agents.
A well-documented API is far easier for AI to interact with than an ever-changing UI and allows better interactions. It has never been more critical to build excellent API docs and push forward with API design first principles. Whether you need to integrate AI into everything is an entirely different question, but good API docs are always important, and now you have another reason to care about them.
From the whole API's You Won't Hate team, we hope you have a great 2025.
-- Alexander, Phil and Mike
The API Round-Up
API News, links, and tools from around the web
API Design
Phil has been working hard with Speakeasy to create a comprehensive guide to API Design. It covers everything from structuring URLs to request bodies, pagination, and more. The content is fantastic, with the main focus on principles and understanding rather than code.
Go Developer Survey 2024 H2 Results
The 2024 Go Developer Survey is out and contains some interesting results. I am sure your main question is, why share this in an API newsletter? 75% of Go developers reported using Go to build API/RPC services. I encounter Go in so many API systems these days, so maybe it's time to give Go a go 😜.
A visual interface for working with OpenAPI Overlays
The team at Speakeasy put together this handy little browser-based tool for those of us working with OpenAPI Overlays. It's a great way to validate that your overlay's JSONPath is working correctly to update values in your schema.
OpenAPI Parser
After getting extremely frustrated maintaining swagger-parser against his will, Phil reminds us that Scalar has a superb OpenAPI parser. Scalar's parser supports OpenAPI 3.1, 3.0 and Swagger 2.0. The constant upgrades make it worth moving over if you're still using the old swagger-parser.
OpenAPI Arazzo in Go
Speakeasy has released a Go library for working with OpenAPI Arazzo documents. They use it in production for their end-to-end testing product, so it's definitely worth checking out.
Speakeasy: Build APIs Your Users Love
Your API deserves a great developer experience. Get one by using Speakeasy to generate idiomatic, type-safe SDKs from OpenAPI
Start GeneratingAPIs You Won't Hate
The latest from the team at API's You Won't Hate.
Testing HTTP Middleware in Laravel
A short and to the point tutorial on adding tests for HTTP middleware in Laravel. Using Pest or PHPUni, see how easy it is to set up tests for your custom Middleware.
Generate SDKs with Speakeasy
Phil has put another API guide together for Bump.sh. Phil walks you through using Speakeasy to generate SDKs from your OpenAPI docs. Phil covers configuring Github, publishing the packages and using overlays.
From our Community
Articles written and shared in our free Slack community.
Privacy-conscious API request logging
Simon Gurcke from our community has an exciting indie project for monitoring REST APIs. They recently released a request log feature to bridge the gap between metrics and raw logs. Privacy features have also been rolled into the log process. Nice work, Simon.
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, James D, Bill D, Rich, and Umair. Your support means the world to us!
Catch you on the flip side!
Alexander, Phil & Mike
