API Design & Governance

Naming, pagination, filtering, errors, versioning, and style guides at scale.

  • 3 Tracked terms
  • Last 30 days Feed window

What this topic collects on

An article joins this feed when it matches these terms. Each one is also a search of its own.

Latest in API Design & Governance


infoq.com > news > 2025 > 12 > orpc-v1-typesafe

oRPC Releases Version 1.0 with OpenAPI Support and End-to-End Type Safety

1+ day, 14+ hour ago   (424+ words) QCon AI Boston (July 8-9, 2027): Agents. Context. Evals. Security. See how other teams make decisions. Register Now Susan Chang explains how Elastic transitioned from siloed, ad-hoc AI agent evaluations to a unified, production-grade framework. She discusses balancing LLM-as-a-judge with deterministic rules,…...


dev.to > imapphelp > my-openapi-changelog-generator-found-1900-breaking-changes-a-formatter-had-just-reordered-every-ojp

My OpenAPI changelog generator found 1,900 breaking changes — a formatter had just reordered every key

1+ week, 11+ hour ago   (206+ words) I built an OpenAPI changelog generator because API release notes are miserable to write by hand: diff two specs, get a structured list of breaking changes — removed paths, changed types, new required fields. The first real run humbled me. I…...


dev.to > oplante > openapi-agent-ready-docs-zip-in-one-click-llmstxt-mcp-stubs-postman-om6

OpenAPI agent-ready docs ZIP in one click (llms.txt, MCP stubs, Postman)

1+ week, 4+ day ago   (136+ words) Agents don't browse Swagger UI the way humans do. They need structured maps, tool stubs, and copy-pasteable examples — not a wall of endpoints meant for clicking. SpecPack (openapi-agentpack) takes an OpenAPI 3.x spec (drop a file or paste JSON/YAML)…...


sapling.ai > docs > openapi

OpenAPI Specification | Sapling.ai Developer Documentation

1+ week, 6+ day ago   (218+ words) Sapling publishes a machine-readable OpenAPI 3.1 description of its REST API: The spec describes the public endpoints you can call with an API key: Operations are grouped by tag (proofreading, generation, detection, analysis, files, account, service), so generated clients get one…...


dev.to > skyblueballykid > i-diffed-githubs-stripes-and-openais-openapi-specs-three-vendors-three-totally-different-3pe1

I diffed GitHub's, Stripe's and OpenAI's OpenAPI specs. Three vendors, three totally different change regimes.

2+ week, 2+ day ago   (384+ words) Method: for each vendor, two commits of their spec repository — a baseline and a current one — counted operations, and looked at what was removed or newly marked deprecated between them. The commit shas are below so you can reproduce this…...


dev.to > christopherdond > i-turned-a-real-openapi-into-an-mcp-server-in-5-min-without-losing-custom-code-on-regen-2j2k

I turned a real OpenAPI into an MCP server in 5 min (without losing custom code on regen)

2+ week, 4+ day ago   (145+ words) 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, you get a 200-tool server. Nobody can use that. That was the exact feedback I got on…...


dev.to > deepaksatyam > we-scanned-1939-repositories-95-of-projects-publishing-an-openapi-spec-have-no-compatibility-51of

We scanned 1,939 repositories. 95% of projects publishing an OpenAPI spec have no compatibility gate.

2+ week, 6+ day ago   (1184+ words) We went looking for projects that publish an OpenAPI specification and then let anything through CI unchecked. We expected a niche. We found the default. Of 85 repositories with a genuine first-party OpenAPI spec, exactly four run any breaking-change detection at…...


dev.to > sunnydachs > your-openapi-spec-is-a-contract-nobody-is-checking-it-i-built-a-cli-that-detects-spec-code-drift-23ah

Your OpenAPI spec is a contract. Nobody is checking it. I built a CLI that detects spec↔code drift with zero dependencies.

2+ week, 6+ day ago   (358+ words) An OpenAPI spec is not just documentation. SDKs, frontend types, API docs, mock servers — everything is generated from the spec. When the implementation drifts from it, everything generated starts lying quietly. This is about oas-drift, a CLI I built that…...


dev.to > anirudhagadekar > virtual-sandbox-from-swagger-spec-build-a-working-openapi-mock-18fa

Virtual sandbox from Swagger spec: build a working OpenAPI mock

3+ week, 10+ hour ago   (178+ words) You have an OpenAPI file. The frontend needs an API URL today. The backend is still being built. For this walkthrough, I uploaded a small product catalog spec to Beeceptor and called the generated routes. GET /products returned HTTP 200 with…...


getminds.ai > docs > api > openapi

OpenAPI Spec & TypeScript Clients

4+ week, 21+ hour ago   (224+ words) Machine-readable OpenAPI 3.1.0 spec for the Minds API. Generate typed TypeScript clients or pipe the JSON straight into your LLM. The Minds public API ships a machine-readable OpenAPI 3.1.0 spec. Build typed clients or give the JSON to an LLM for routes with…...