Swagger / RAML（或任何类似的REST API规范）是否支持REST异步客户端回调？

Question

我想使用REST异步客户端回调，这意味着当响应准备好时，服务器会在客户端调用回调操作（请参阅Jersey's 'Asynchronous Services and Clients'以获取我的意思）

我可以在Swagger / RAML /类似的东西中表达这一点，并享受相关的服务器/客户端代码生成，文档生成等吗？你能指出相关的例子/资源吗？

Answer 1

美国原子能机构（前称Swagger）认为：
https://github.com/OAI/OpenAPI-Specification/issues/716
https://github.com/OAI/OpenAPI-Specification/issues/737
甚至合并了callback feature并登陆OAS 3.0 但是我使用的工具似乎并不支持此时的添加。

Answer 2

据我记得，OAS 3.0附带了它。所以还没有一种支持这个功能的工具。

Answer 3

签出Async API

引用https://www.asyncapi.com/v1/guide/

  

AsyncAPI提供了一个规范，该规范允许您以机器可读的格式定义消息驱动的API。它与协议无关，因此您可以将其用于在MQTT，AMQP，WebSocket，STOMP等上运行的API。该规范与OpenAPI / Swagger非常相似，因此，如果您熟悉它们，则AsyncAPI应该很容易使用

回购：https://github.com/asyncapi/asyncapi

异步API支持

• 文档生成：https://www.asyncapi.com/v1/tooling/docgens.html
• 代码生成（Java，Node.js）：https://www.asyncapi.com/v1/tooling/codegens.html

---

还有Swagger 回调功能（documentation for the callback feature.）