Unifying OpenAPI & AsyncAPI : Designing JSON Schemas+Examples.
summary
Claims that a single shared JSON Schema and example set removes duplication between OpenAPI and AsyncAPI, demonstrated by extracting common components and ref’ing both specs; shows a runnable mock and sandbox via Specmatic virtualize/test that serves Swagger UI and runs Kafka mocks; runs contract tests that auto-generate tests from examples and reports an API coverage 50% in the demo; exercises a Kafka request–reply flow, verifies messages in a local broker, and highlights conformance checks and backward-compatibility testing.
AI-written summary · about
chapters (9)
- 0:00Unifying OpenAPI & AsyncAPI
- 3:41Real-world API scenario
- 6:08Duplicated schemas challenges
- 9:58Reusable components design
- 12:47API lifecycle & DX
- 20:11Live demo: schema reuse
- 24:26AsyncAPI mocking & testing
- 28:23API evolution & compatibility
- 30:28Closing remarks
related talks
27mAsyncAPI & The future of API specs
19mUnlock API and Data – The Power of Data Model and Governance
26mThe API Specficiations Toolbox
21mLet there be docs!
19mGenerating & Using AsyncAPI Specs from Real-World API Data
01h 03mOpenAPI and AsyncAPI, when to use which and why
30mOne Spec to Rule them all - OpenAPI in Action
47mDesign First: OpenApi and AsyncApi in Action!