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.

Share
Quality Matters

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:

🫢
Support us as a GitHub Sponsor, or upgrade your subscription to become a paid Community Member

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 today

Thanks so much to our members: KinJuxt, 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