如何分享Swagger文档

12

我最近开始使用Swagger进行文档编写,但有些事情仍不清楚。我创建了YAML文档,现在我想能够与我的团队共享我的文档,以.pdf或HTML / JavaScript页面的形式。我无法使用SwaggerHub,因为它们没有私有存储库,并且Swagger Editor似乎不允许共享右侧面板。

只是为了明确,我想要像下面这样的东西:

输入图像描述

我错过了什么?

2个回答

1

我有偏见,因为我在SwaggerHub上工作,但这就是该项目的目的:

https://swaggerhub.com

从那里,你可以自动将你的 swagger 规范推送到 github,并且还可以将其他用户设为 API 的合作者(或只是只读)。

0

我们正在尝试与另一家公司合作,但只有基本的四个许可证团队安排。这是我们正在开发的产品,因此我的API必须是私有的。我正在使用SwaggerHub,但很失望地看到,用户只能在他们是“协作者”并且被付费许可证覆盖时才能看到我的私有API(您可以轻松地在SwaggerHub上共享公共API)。我想这意味着将HTML文档(您可以从SwaggerHub API下载)托管在我自己的云托管的Swagger UI实例中,并将其保护在登录后面...欢迎提供建议!


网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接