是否有一些工具可以从 YAML 中的 Swagger/OpenAPI 规范生成 MS Excel/MS Word 格式的 REST API 规范或任何其他人类友好的表格文档。 BA 和 Web 开发人员应该可以通过最少的修正来访问结果。关于列和结构我没有特别的建议,越可读越好。
最好是python或者js脚本,不过Win10工具和在线都可以。如果您建议使用通用 YAML 或 Json CSV/HTML 表转换器,请说明为什么您认为它非常适合此任务。
更新。 Online Swagger Editor 实际上做得不错,我可以将结果复制到 OpenOffice Writer,然后手动编辑以获得最佳外观。在 Calc 中,文档看起来更暗淡,但我仍然希望文档可以通过表格处理器看起来更清晰、更有吸引力。
如上面所列,Swagger UI 背后有一个 JSON 文档。可以用 Python 中的请求来调用它。然后解析出你感兴趣的元素。
看看我的项目https://github.com/pszybiak/openapi-2-excel。它仍在开发中,但您可以生成大部分信息。 请随时发表评论或报告错误和开发建议。
该库为 Swagger(OpenAPI) 提供 Excel 编辑器 JSchemaTool