OpenLint is here to automate your API Style Guides
From JSON Schema to Arazzo to OpenAPI, OpenLint has grown enormously. Also in this newsletter: farewell ts-rest, a podcast with Skyvern, Train Travel's OpenAPI 3.2 spec, and more!
If you're not in our Slack community group, you may have missed the flurry of work happening on OpenLint. If you have been looking for an OpenAPI linter, then honestly, look no further. OpenLint can validate your OpenAPI, JSON Schema, Arazzo and AsyncAPI documents, but its real power is automating API style guides. You can write your own rules to ensure your API stays compliant as more and more pull requests pile in. Check out the Getting Started Guide or the GitHub project.
-- Alexander
The API Roundup
API News, links, and tools from around the web
The Train Travel API Moves to OpenAPI 3.2
All aboard. Sorry, that was a terrible joke. Anyway, thanks to Polo from Bump, the Train Travel API example got bumped to OpenAPI3.2. Kin Lane runs us through the updates. Great to have this example updated. For me, this was one of the first API specs I ever interacted with.
Goodbye ts-rest
A co-worker recently showed off his CI pipeline built with TypeScript functions, because, well, who likes YAML. This sent me down a path of looking at tools that compose OpenAPI Spec via TypeScript. Who doesn't want a clean, easy, type-safe way to compose your spec? In my search, I stumbled across ts-rest. It works with many validation libraries like Zod and Valibot and plugs into Express, Next, Fastify, and more. However, I was surprised to find that it was archived only a few days ago, though forks are welcome.
Rethinking HTTP in Node.js
If you missed Node Conf this year, there were some amazing talks, and one in particular caught my eye: Rethinking HTTP in NodeJS. So why does Node need a new HTTP server, and what are the limitations with the current version? Jump into a great talk by Marco Ippolito on the future of Node's HTTP server and what this work could mean for the future of server-side JavaScript.
Why OpenAPI and JSON Schema matter for AI-assisted Development
This post/video feels a little like a marketing spiel, but it has some interesting messaging, and that's how important Microsoft sees specifications like OpenAPI. The section on using OpenAPI, TypeSpec, and JSON Schema to accelerate work and improve quality hits the mark on deterministic tooling. In a world of LLM-driven software, specifications can help ensure quality, and this is further proof.
Better HTTP/1 Connection Reuse in Go
Making an HTTP request with Go using HTTP/1 gets almost five times faster in Go 1.27. Nicholas walks you through the cost of making a HTTP connection and connection reuse, where it failed, fixes and how it has now improved in Go.
APIs You Won't Hate
The latest from the team at API's You Won't Hate.
🎙️ Skyvern, 2 years later: Browser Automation for Everyone
Mike chats with Skyvern's founder Suchintan Singh on ditching RAG in a rewrite that's 2.3x faster and ~50% cheaper, plus browser automation for non-coders, trust and pricing.
From our Community
Articles written and shared in our free Slack community.
API failure stories and what they taught me
A wonderful article shared in our Slack community, sharing some API failure stories. We start with some fun issues around versioning, how this fails during a migration and eventually a nice little one on authentication vs authorised. What's funny is I feel like we all have these stories. Maybe we are doomed always to repeat our mistakes.
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, Nolan S, Brandon K, Frank, James D, and Bill D. Your support means the world to us!
✌️ Until next time,
Alexander, Phil & Mike
