【问题标题】:Swagger/OpenAPI to a human readable document (Excel, Word ...) conversionSwagger/OpenAPI 到人类可读文档(Excel、Word ...)的转换
【发布时间】:2017-09-06 01:38:48
【问题描述】:

是否有一些工具可以从 YAML 中的 Swagger/OpenAPI 规范生成 MS Excel/MS Word 格式或任何其他人类友好的类似表格的文档。 BA 和 Web 开发人员应该可以通过最少的修正访问结果。我对列和结构没有特别的建议,越可读越好。

最好是python或者js的脚本,但是win10工具和在线都可以。如果您建议使用通用 YAML 或 Json CSV/HTML 表格转换器,请说明您为什么认为它非常适合此任务。

更新。 Online Swagger Editor 实际上做得不错,我可以将结果复制到 OpenOffice Writer,然后手动编辑以获得最佳外观。在 Calc 中,文档看起来更暗淡,但我仍然希望使用表格处理器使文档看起来更清晰、更具吸引力。

【问题讨论】:

  • 您是否考虑过使用 Swagger UI 来呈现 API 规范?在petstore.swagger.io查看演示。
  • 谢谢,看起来好多了
  • 有谁知道 online swagger 是否将 API 信息发送到云端(这对于机密项目来说并不酷)?他们的swagger.io/terms 是 404。
  • Fuhrmanator,值得一个问题恕我直言,你试过问他们吗?如果您使用代码生成器,我相信云会踢,但不确定休息
  • 可以导出到excel吗?

标签: excel swagger export-to-csv


【解决方案1】:

如上所示,Swagger UI 后面有一个 JSON 文档。可以用 Python 中的请求调用它。然后解析出你感兴趣的元素。

【讨论】:

    【解决方案2】:

    这个库为 Swagger(OpenAPI) 提供 Excel 编辑器 JSchemaTool

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2010-09-19
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多