...Surely you mean to call it OpenAPI?
How long can an old name last? We're still trying to get people to say OpenAPI instead of Swagger. Also: Vacuum linting, OpenAPI for Rust Crates, a new Nock, and more!
The OpenAPI specification was originally called Swagger before SmartBear transferred it to the OpenAPI Initiative.
Despite the official name change, the term "Swagger" persists. For me, Swagger represents all the old, janky tools I have grown to dislike, while OpenAPI represents tools like Stoplight that feel more modern. The Swagger name sticks around primarily due to its deep roots in enterprise software and older frameworks like Spring Boot, whose ecosystem moves slower, and its tools are more challenging to update.
While OpenAPI is now the correct term for the specification, the Swagger name likely won't fade away anytime soon.
-- Alexander
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 GeneratingThe API Round-Up
API News, links, and tools from around the web
API Linting with Vacuum
I have mentioned Vacuum before, but Phil provides a step-by-step guide in this blog post. Vacuum is an open-source OpenAPI linter written in Go. It is fast and also supports the Spectral rule sets.
OpenAPI Spec for Rusts Crates API
Crates.io is the place to download and publish Rust libraries. Recently, they published an OpenAPI spec. Unfortunately, due to security concerns, they did not ship a viewer, but they made good progress nonetheless.
OpenAPI Initiative: New Standards
The OpenAPI landscape is changing. Overlay and Arazzo specifications are enhancing API standardisation and orchestration. Lorna Mitchell walks us through the changing landscape and what's next for OpenAPI.
Node File Router
A file-based router for Node inspired by Next.js and Nuxt works with Bun, Node, Express, and more. It has zero dependencies and supports TypeScript, Common JS, and ESM. It's time to build some file-based APIs.
Nock V14
Nock dropped version 14 over a week ago, and I could not be more excited. Nock is my go-to HTTP server mocking library for Node.js. For example, it is excellent for mocking HTTP requests to the AWS API. After listening to API calls, the recorder function prints out the code for you, which is fantastic. Not to mention, the new version brings support for native fetch.
Building Great APIs with Powertools
Learn how to build REST APIs on AWS Lambda using Python and Lambda Powertools. Check out how Powertools can help you with routing, validation, and OpenAPI support. You will be up and running with serverless APIs in no time.
Open Source User Authentication
Trusted by 2K+ production applications including HackerRank and ESPN
Learn MoreAPIs You Won't Hate
The latest from the team at API's You Won't Hate.
OpenAPI Bundling Tools, compared
Compare Swagger CLI, JSON Schema Ref Parser, and Redocly CLI for OpenAPI bundling. Discover which tool best suits your API documentation needs.
APIs You Won't Hate on YouTube, too!
A community member recently asked if we could repost podcast episodes on YouTube. Turns out - we've been doing exactly that for ages, but we don't talk about it much! We even publish a pod with video every now and again...
From our Community
Articles written and shared in our free Slack community.
Share Virtual Keys, not API Keys
Burch shared this fantastic project he has been working on in our Slack community. Subkeys is a clever platform that lets developers track API usage with Virtual Keys, making it easy to catch and fix costly API issues in seconds.
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!
Until next time,
Alexander, Phil & Mike
