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


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)

6+ hour, 31+ min 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.

1+ day, 12+ hour 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.

1+ day, 19+ hour 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

2+ day, 22+ 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

1+ week, 3+ day 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…...


dev.to > manoharij > swagger-and-openapi-the-docs-that-write-themselves-2hp4

Swagger and OpenAPI: The Docs That Write Themselves

2+ week, 3+ day ago   (737+ words) The key thing to understand: you don't hand-write this specification. It's generated automatically by reflecting over your existing controllers, DTOs, and attributes, which is exactly why it can't silently drift out of date the way a manually maintained wiki page…...


dev.to > usamadanbaiwa > have-you-ever-experienced-an-api-integration-where-the-production-environment-is-different-from-the-50oc

Have you ever experienced an API integration where the production environment is different from the test environment?

3+ week, 2+ day ago   (238+ words) As a Software Engineer, i have integrated a lot of third party APIs. Some were great some are okay and some were frustrating We were tasked to integrate a large, well established company API and the documentation is fine, we…...