如何通过OpenAPI定义消息总线合约 能否在Stoplight Studio中使用

首先明确结论：OpenAPI原生不支持消息总线、异步消息通信类场景的定义需求。

• OpenAPI规范的设计目标是覆盖HTTP/REST等同步请求-响应模式的API建模，没有内置消息主题、订阅消费模式、消息队列绑定、事件触发规则这类异步通信场景需要的核心元数据定义能力，强行使用OpenAPI定义消息会出现大量非标自定义扩展，失去规范标准化的价值。
• 你可以换用和OpenAPI同生态的AsyncAPI规范完成消息定义工作，该规范专门面向事件驱动架构、消息总线场景设计，语法规则、JSON Schema定义逻辑和OpenAPI高度一致，你团队之前使用OpenAPI积累的建模经验、现有数据结构定义基本都可以直接复用，学习成本极低。
• Stoplight Studio原生支持AsyncAPI规范的编辑、校验、文档生成能力，操作逻辑和你之前编辑OpenAPI合约完全一致，不需要更换工具，可以直接沿用现有工作流程完成消息定义工作。

内容的提问来源于stack exchange，提问作者Neil