#openapi

Articles tagged with #openapi

Give Your API Agent a Definition of Done
A create-read-check scenario connects an API contract, MCP tools, and observable outcomes. Here is how to make completion something you can verify.
Oct 9, 20263 min read
I Scanned Dozens of Real Backends into OpenAPI. Here's Why the Naive Approaches Fail.
Hand-writing OpenAPI drifts, regex mistakes cache.get() for a route, and asking an LLM to summarize a repo hallucinates endpoints. Here is the deterministic way to scan real codebases into OpenAPI 3.2: prove the contract, flag every gap, and let AI fill only what it cannot invent.
Oct 9, 20268 min read
Stop Testing Your API With the Same Perfect Request
Your favorite saved request probably exercises the easiest path. Change one input at a time to find the assumptions hiding behind a green Send button.
Oct 9, 20264 min read
Your cURL Command Works. That Doesn't Make It API Documentation.
A working request is a great starting point. Before handing it to another developer, answer the questions a cURL command cannot: what is required, what can vary, and what happens when it fails?
Oct 9, 20264 min read
The Most Useful API Review Starts With a Diff, Not a Demo
A demo shows that the new path works. A contract diff shows what existing callers now have to survive. Here is a focused way to review an API change without turning it into a committee meeting.
Oct 9, 20264 min read
I Would Rather See Unknown Than an AI-Invented API Contract
An AI-generated schema can be valid, detailed, and wrong. A delegated handler shows why more context is not enough—and what an evidence-based review should check.
Oct 9, 20265 min read