Quality Matters
Code quality means API Quality means customer experience means less churn and more growth. Also in this newsletter: Swagger support for OpenApi 3.2.0, Hey API, and how to deal with OpenAPI Changes.
I stumbled across a new tool this week, Hey API; however, it wasn't just the tool that caught my eye. A contribution from one of their community members led to significant performance improvements when parsing OpenAPI. Then, Hey API follows up with recognition and financial compensation. Amazing to see the hard work recognised and rewarded.
We are currently living in an era where people want us to stop caring about quality. To ship 100x more, to merge without checking and spend more tokens.
It's really great to see the focus on quality and end-user experience in the OpenAPI space.
-- Alexander
The API Roundup
API News, links, and tools from around the web
OpenAPI Support Comes to kin-openapi
It's got Phil excited, and it got us excited as well. kin-openapi has finally shipped OpenAPI v3.1 support. Great news: this now gets them off the legacy page on openapi.tools. The leap from 3.1 to 3.2 is not as difficult, so hopefully we will see this soon.
Swagger launches support for OpenAPI 3.2.0
Another OpenAPI upgrade hit us this week: Swagger rolled out support for OpenAPI 3.2. While I was getting excited about this release, a little unease hit me when they talked about AI being a core part of their workflow. I get it, everyone is scrambling to talk about how they're AI-native now, but really, that means nothing. The quality of the output and how well it works are what matter.
Hey API
OpenAPI to Typescript in seconds. Honestly, I'm wondering where this has been all my life. Hey, API takes your OpenAPI spec and turns it into a TS SDK or an HTTP client for Fetch, Angular, Axios, and more. However, they don't stop there; you can create plugins for Zod, TanStack Query, etc. Honestly, I'm shoving this into my work projects tomorrow.
Error translation in Go services
Are you accidentally exposing SQL errors to your Go API's clients? It can be easy to let these things slip in any system. Jump into a nice, easy-to-read post on how to catch those pesky errors on the service boundary, turn them into domain errors and stop your internals leaking.
Fetch-Extras
Writting fetch functions in JavaScript can sometimes be a little time-consuming and repetitive. Especially when you find yourself building the same wrapper in every project. Enter Fetch-Extras, which allows you to compose just the extra features you need over fetch. No need to learn a new framework, it's just fetch. Works in Browsers, Node.js, Deno, Bun and Cloudflare Workers. Super easy fetch clients.
APIs You Won't Hate
Articles written and shared in our free Slack community.
Support APIs You Won't Hate
APIs You Wonβt Hate exists to help developers build better APIs. We are independent, deeply practical, and run a team of 3 people supporting a growing community.
If our work has helped you or your team, there are two ways to support us:
Thanks as always for your support - it means the world to us!
From our Community
Articles written and shared in our free Slack community.
OpenAPI Changes Suck
A reflection on the first version of openapi-changes by its author, Quobix. While being a little too harsh on himself, Quobix talks us through the new version and the changes he has made. The React to Web Components part also caught my eye. Can't wait to try out the new version.
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, Juxt, Alex R, Nolan S, Brandon K, Frank, James D, Bill D, and Abdelhadi D. Your support means the world to us!
βοΈ Until next time,
Alexander, Phil & Mike