【发布时间】:2017-09-17 00:10:03
【问题描述】:
我们如何在 Swagger 或 RAML 中记录基于消息的 API? 基于消息的意思是端点总是相同的,但是可以向该端点发送多种消息类型,并且根据输入消息的类型,我们会得到不同的响应。 有没有这种类型的 API 示例我可以看看?
谢谢。 路易斯·奥斯卡
【问题讨论】:
我们如何在 Swagger 或 RAML 中记录基于消息的 API? 基于消息的意思是端点总是相同的,但是可以向该端点发送多种消息类型,并且根据输入消息的类型,我们会得到不同的响应。 有没有这种类型的 API 示例我可以看看?
谢谢。 路易斯·奥斯卡
【问题讨论】:
Swagger 和 OAS 特别用于记录类似 REST 的 API。经过长时间的搜索,我找到了AsyncAPI 规范。这可用于记录您的消息驱动 API。
还有一个在线编辑器可用,如果您已经熟悉使用 swagger,yaml 很容易开始使用此规范
【讨论】: