Require that every API is tested against its own contract in the CI/CD pipeline so the running service can never quietly drift from the OpenAPI it publishes. I insist on contract testing because a spec that lies is worse than no spec at all, and the only way to keep the two honest is to check them on every build. Validate requests, responses, status codes, and schemas against the contract, and fail the pipeline when they diverge. This is the automated conscience that lets teams move fast while keeping the promise their documentation makes to consumers.
Contract Testing (CI/CD)
Strategies
API Delivery Is Fast and Design-First
API delivery must follow a design-first approach with mock servers, contract testing, and schema registries that enable parallel development, allowing consumers to begin integration before implemen...
API Governance Is Automated in CI/CD
All API governance checks including linting, contract testing, and schema validation must be automated within the CI/CD pipeline, ensuring that governance is enforced consistently at build time rat...
Experiences
Quality
The quality of HTTP APIs powering an enterprise tends to decline as the number of ungoverned APIs grows across internal, partner, and public landscapes. Low-quality APIs lead to poor downstream exp...
Contracts
Every API is a contract, and the contract experience is about how clearly the promises between provider and consumer are expressed. Technical contracts like OpenAPI and AsyncAPI describe what the A...
Velocity
Velocity is the experience of how quickly teams can deliver and evolve APIs, and how quickly consumers can build with them. It comes from automation, good tooling, design-first practices, and remov...
Lifecycle
description Definitions Define
The definition is the contract. OpenAPI, AsyncAPI, JSON Schema, and APIs.json are the machine-readable artifacts I use to describe what an API is before, during, and after it exists. Investing in s...
checklist Testing Beta
Testing is how I know the API does what the contract says. Contract testing, integration testing, and validation against the definition keep implementation and documentation honest with each other....
tune Management Production
Management is the day-to-day operation of an API in production. Plans, rate limits, keys, and access all get administered here, usually through a gateway. Solid management is what lets me offer an ...
