如何共享Swagger文档

pbpqsu0x  于 2022-11-06  发布在  其他
关注(0)|答案(2)|浏览(249)

我最近开始使用Swagger制作文档,但有一些事情我还不清楚。我创建了YAML文档,现在我希望能够与我的团队其他成员共享.pdf或HTML/Javascript页面中的文档。我不能使用SwaggerHub,因为他们没有私有存储库,而且Swagger编辑器似乎不允许共享右侧的面板。
只是为了明确,我希望能够得到这样的东西:

我错过了什么?

jexiocij

jexiocij1#

当我在swaggerhub上工作的时候,我是有偏见的,但这就是这个项目的目的:
https://swaggerhub.com
从那里,你可以自动将你的swagger规范推送到github,并让其他用户成为API的合作者(或者只是只读的)。

e4yzc0pl

e4yzc0pl2#

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

相关问题