Query Is Here

The new HTTP QUERY method is here, so stop shoving read-only operations into POST because your query strings get messy. With QUERY officially being supported in OpenAPI 3.2 and many web frameworks now supporting it either directly or via custom methods, adoption has never been easier. A common misuse today is complex filters and searches being shoved into a POST, that works, but it hides the real semantics. POST does not tell clients, caches, observability tools, or retry logic that the operation is safe and idempotent. Start using QUERY today.

-- Alexander

OpenAPI Python

HeyAPI is at it again, delivering more OpenAPI goodness, this time with a Python Code Generator. Their new package converts OpenAPI into production-grade SDKs or Pydantic models. Honestly, at the rate I bring up HeyAPI, I should get myself a t-shirt.

Unified API

One API for LinkedIn, Instagram, Messaging, Email & Calendar - sponsored

GraphQL 17

Being the first major release since October 2021, GraphQL is dropping some goodies in this latest release. First class AbortSignal support, broader schema validation coverage, GraphQLHarness for customisation and more. A great release that really expands GraphQL.

OpenAPI Is the Unit of API Governance

A great post by Kin Lane about how your OpenAPI is the Unit of Governance and how this is increasingly important with AI. Humans can push through bad descriptions; LLMs will take it at face value.

The info.description, the operation summary and description, the parameter descriptions, the schema property descriptions — this is where engineering and product actually negotiate what the API is.

FastAPI Now Serves Frontend

FastAPI is a web framework for building API's with Python with a focus on performance. Thanks to FastAPI's hard work, you can now serve static frontend apps with support for React with Vite, TanStack Router, Astro, Vue, Svelte, Angular, Solid, and any others that produce a static build.

HTTP Cookie Parser Faster and Slimmer

Cookie is a Node library for parsing and serialising HTTP Cookies and recently landed a killer release. Cookie is now ESM only and has some nice performance improvements. Being part of E18E this really made my heart sing. Feels like so many libraries in the Node/Express ecosystem have been getting upgrades recently.

Socket-Activation for a Go HTTP service

I removed and added this post to the newsletter a few times this week. It's not strictly API-focused, but I found it so interesting that it's worth sharing. Chris walks us through setting up an HTTP service that only spins up and uses its full resources once you hit the endpoint. Might have limited uses, but a great read and learning exercise.

APIs You Won't Hate

The latest from the team at API's You Won't Hate.

Newsletter Feedback 

We have been running the API's Newsletter for a few years now and would love to hear from our readers. What do you want to see more of, less of, and what are we missing? We have set up a Slack channel in our community, so head on over and leave us some feedback. We can't wait to hear from you.

From the Community

Articles written and shared in our free Slack community.

Portman

Can't believe I missed this one. One of our community members was looking for API testing tools to ensure a service meets its API contract. Portman was shared as a way to automate contract and variation testing running locally and in your CI/CD.

Thanks 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