当前位置: 首页 > 知识库问答 >
问题:

通过Swagger描述websocket api

郦何平
2023-03-14

是否可以通过 Swagger 描述 Websocket server api?

我们通过websocket服务器广播事件,我想通过一个swagger规范文件来描述它们。

是否有用于WebSocket的文档生成器?

共有2个答案

仇正平
2023-03-14

不是一个文档生成器,但它确实可以对套接字进行文档编制

消防营地-https://firecamp.io/类似于邮递员,但也进行websocket和socketio连接。因此,您可以在那里记录套接字连接,并将其导出到集合中,就像我们在Postman中使用API一样。

辛承志
2023-03-14

使用swagger套接字似乎是可能的。

尽管如此,目前似乎只有Java / Scala服务器实现存在,这意味着它们不像“标准”Swagger REST服务那样多。

编辑:正如所指出的,这个项目似乎已经死了。不幸的是,在更新此答案时,Swagger似乎不是用于类型web套接字消息的好工具。

 类似资料:
  • 我有一个字段有更大的描述。 在swagger-ui页面中,描述是内联的。在对模型进行文档化时,有什么方法可以让“\n”起作用吗?

  • 问题内容: 有没有一种方法可以通过脚本更改/更新和删除/删除列说明? 我用来添加描述,但不允许更新。当我尝试使用相同的sp来更新现有的描述值时,它说类似“ description属性已经存在” 对我来说,更改或删除/创建类似的解决方案都是可以的。 解决方案 经过有用的回答和评论后,您可以在下面看到我的最终解决方案。可以帮助某人。 问题答案: 结合Steph Locke的建议,您可以使用以下方法检查

  • 我通过compojure-api使用ring-swagger。我有几个查询参数,我正在努力寻找一种方法来向单个查询参数添加描述。我可以添加整个endpoint的摘要,但这还不够。 是否可以使用ing-swagger/compojure-api向单个查询参数添加swagger描述?

  • 我试图用Swagger来描述我正在构建的web-api。问题是我无法理解如何描述复杂的json对象? 比如如何描述这个对象:

  • 我想格式化我的Swagger API描述,使它们不是简单的文本段落。最好是,我想在其中添加一个小表格。 我没有在Swagger描述中找到有关文本格式的在线参考。如果我启动Swagger编辑器,并打开Instagram示例(File \ Open Example \ Instagram.yaml),我看到yaml文件中的第一个描述显示了一些格式,包括超链接和边界框: 这看起来像标准的Markdown

  • 我正在用Swagger创建一个API文档。我直接尝试了openapi 3.0。不知何故,我无法得到我的请求机构工作的描述。 但这些描述不会出现: 我想得到像《大摇大摆2》那样的东西。下面是如何将相同的代码转换为Swagger 2