Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Schema Registry (CI/CD)

Require that the schemas an API relies on are published to a shared schema registry and validated against it in CI/CD, so the shapes of our data are versioned, discoverable, and compatible. I want a registry because the same data structures show up across many APIs and events, and letting each team redefine them privately is how drift and duplication creep in. Register the schemas, check compatibility on every change, and reuse them by reference instead of copy and paste. This gives us one source of truth for our data contracts and turns compatibility from a hope into a checked guarantee.

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

Reusability

Reusability is the experience of finding and applying an existing API instead of building the same capability again. It depends on discovery, consistent design, and clear documentation that make an...

Consistency

Achieving consistency in the design, delivery, and maintenance of HTTP APIs across an enterprise is a significant challenge—one that often complicates API operations. Small differences, such as var...

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...

Lifecycle

design_services Design Design

Design is where the human experience of an API is won or lost. I work design-first, shaping the paths, schema, errors, and naming in the contract before development begins, so that consistency is b...

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 ...