Where Should Your OpenAPI Spec Live?
Repo or hosted is the wrong question. What decides whether your API has one contract or several is which copy the others derive from, and who runs that step.
Routebase Blog7 min read
API Design
9 stories
Why API Style Guides Fail With Too Many Rules
Most style guides fail with too many rules, not too few. The work is deciding which rules stop a build, which leave a note, and which you will never enforce.
Routebase Blog7 min readAPI Descriptions That Pass the Linter and Fail the Agent
A linter flags a missing description, not a useless one, and the useless one is what an agent chokes on. What to write, what to leave out, and how to test it.
Routebase Blog6 min readWhy Your OpenAPI Spec Drifts (and How to Catch It)
Every API contract decays once nothing enforces it. The four ways specs drift, why code generation does not save you, and how to make the spec true again.
Routebase Blog5 min readConsistent Error Handling with RFC 9457 Problem Details
Why every API needs exactly one error shape, how RFC 9457 Problem Details provides it, and the conventions that make it stick across every endpoint.
Routebase Blog6 min readAPI Design Principles: A Practical Guide
Six design decisions that make or break an API, from resource modeling, naming, and idempotency to pagination, error formats, and versioning, with examples.
Routebase Blog5 min readDesigning Agent-Ready APIs
AI agents are becoming API consumers. What that changes about API design, from descriptions as prompts and actionable errors to MCP as the new surface.
Routebase Blog5 min readDesign-First vs. Code-First API Development
Two workflows for building APIs, and why the order you write the contract in changes everything downstream, from parallel work and review quality to drift.
Routebase Blog4 min readVersioning APIs Without Breaking Your Consumers
What actually counts as a breaking change, why additive evolution beats version bumps, and how to run a deprecation your consumers will forgive.
Routebase Blog4 min read
Showing 9 of 9 stories
You're all caught up.
AiByts Weekly Brief
Get the top AI news and tools straight to your inbox every week.
Weekly · AI news
Join 15,000+ AI enthusiasts