How to document error responses in FastAPI
FastAPI generates an OpenAPI schema for you, but by default it says almost nothing about how your API fails. This guide builds that part of the sche…
Последние новости
⚑ Сообщить о проблемеTech news from the best sources
Все темы
AI
Gear
News
Tech
agents
ai
api
architecture
automation
beginners
career
database
devchallenge
devops
discuss
javascript
llm
machinelearning
mcp
opensource
performance
productivity
programming
python
security
showdev
testing
tutorial
typescript
webdev
Pin baseUrl in the Gateway, Not in the Agent's Prompt
The other day an agent I was testing kept hitting production. Not on purpose, not because it was being clever. It was reading the OpenAPI spec we ha…
When the Spec Changes, the MCP Tool List Should Change With It
The first MCP server we stood up, someone on the team wrote out the tool list by hand. A JSON file with 22 entries, each describing one endpoint we…
Your AI coding tool doesn't know your API — and it's inventing endpoints to prove it
You ship a small feature on a Tuesday. The assistant writes the whole thing in one pass: a fetch wrapper, a couple of loading states, error handling…
Are you migrating from Spectral? Redocly just got something to help you with that!
Spectral has been the default OpenAPI linter for years, and it did serve the community well. It made linting API descriptions in CI a normal thing,…
I built 13 labelled OpenAPI breaking-change cases, and oasdiff missed 2 of them
I'm working on Impact Gate, a warn-only PR check that tells you which consumers an API change can affect. Before claiming anything about it, I wante…
Where does your team's API knowledge actually live?
Let me describe a day in the office. Tell me if it sounds familiar. You need to call the payments API. Just one request. Should take five minutes. F…
Your API spec is the prompt: stop re-explaining your backend to every AI
It is Monday morning. A new coding assistant looks promising, so you open a fresh chat and start the ritual: paste the API docs, explain the auth he…
Three Years Later: What Happened to 1,927 Public API Specs
If you integrated a public API in 2023, you probably read its OpenAPI spec, generated a client from it, and trusted the version number to tell you w…
I turned a real OpenAPI into an MCP server in 5 min (without losing custom code on regen)
I built an OpenAPI to MCP server generator for TypeScript, Python and Go. The v1 mistake: 1 endpoint = 1 tool. On a real API with 200 operations, yo…
We scanned 1,939 repositories. 95% of projects publishing an OpenAPI spec have no compatibility gate.
We went looking for projects that publish an OpenAPI specification and then let anything through CI unchecked. We expected a niche. We found the def…
Your OpenAPI spec is a contract. Nobody is checking it. I built a CLI that detects spec↔code drift with zero dependencies.
"The generated client keeps calling DELETE /items/{id}." "The server returns 405 Method Not Allowed." An OpenAPI spec is not just documentation. SDK…
Reimporting Stripe's new OpenAPI spec into Mockoon left 559 routes on the old API
Disclosure: I work on Mockzilla, which competes with Mockoon. Everything below was run on one laptop, and there is a link to the longer comparison a…
How to Generate Karate API Tests from OpenAPI — Without Creating a Maintenance Nightmare
How to Generate Karate API Tests from OpenAPI — Without Creating a Maintenance Nightmare Generating API tests from an OpenAPI file sounds like an ea…
Prism spent 30 minutes on Stripe's OpenAPI spec and never opened a port
Disclosure: I work on Mockzilla, which competes with Stoplight Prism. Everything below was measured on my laptop, and there is a link to the longer…
WireMock will not read your OpenAPI spec, and that is on purpose
Disclosure: I work on Mockzilla, which competes with WireMock. Everything below was run on my laptop today and every claim links to its source. Ther…
Why is my LLM stream empty? A field guide to broken SSE responses
If you have ever called an OpenAI-compatible API with streaming enabled and received... nothing , you are not alone. No error, no exception — just a…
Adding OpenAPI Support to Mummy, a Nim HTTP Framework
Nim doesn't have a lot of options for building HTTP APIs with the kind of batteries-included developer experience you get in frameworks like FastAPI…
Why Your OpenAPI Spec Isn't Enough for AI Agents
OpenAPI describes an API. Agent Readiness describes whether an agent can actually use it. Your API has a complete OpenAPI spec. Every endpoint, sche…
Optimizing LLM Context for OpenAPI: A Deterministic Approach to Token Reduction
How deterministic context batching reduced approximate token usage by ~81.7% while building an agentic API testing prototype See It in Action I also…
Swagger Isn't Just API Documentation
If you've worked with REST APIs, you've probably encountered Swagger. Many developers initially think: Swagger = API documentation That's not comple…
136 raw removals, 17 real ones: what a spec diff over-reports
Originally published at mendapi.com . Between two published snapshots of the Cloudflare OpenAPI schema — 7abe88500e55 (2026-03-31) → c92b9b0fde23 (2…
Your API provider shipped a breaking change. Here's how to find what it breaks in your code
When Dependabot bumps a dependency, the PR is green, the tests pass, and you merge it on autopilot. Three days later something in production throws…
Contract testing a Symfony API with OpenAPI
Contract testing a Symfony API with OpenAPI takes four moving parts: the OpenAPI spec, a WebTestCase (or a plain Request / Response pair), one trait…
Your OpenAPI spec is already a test plan — here's how to turn it into Playwright tests automatically
If you're writing Playwright API tests manually from an OpenAPI/Swagger spec, you're doing work that should be automated. Every endpoint in your spe…
How to catch breaking OpenAPI changes before they reach production
An API can stay online, return 200s, and still break every client that depends on it. That is the uncomfortable part of API compatibility: the dange…
Build a versioned Laravel API with auto-generated OpenAPI docs in 10 minutes
TL;DR — We'll install dskripchenko/laravel-api , write one controller, and end up with a versioned API ( /api/v1/... ) and interactive OpenAPI 3.0 d…
Pact is great. It's also why most teams don't do contract testing
In 2014, Pact created an entire engineering discipline. Consumer-driven contract testing — the idea that the API consumer, not the provider, should…
Arazzo Visualizer: Run API Workflows in VS Code
Most apps don't just call one API endpoint. They call a whole chain of them. For example, you might log in, get a token, and then pass that token to…
Accept the Official Hack - Build-Time OpenAPI Detection in .NET 10 Minimal APIs
It is straightforward to configure a minimal API to produce an OpenAPI document at build time . This runs the API during build, requests the OpenAPI…