微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

如何为 Swagger 编辑器创建指向受保护 url 中的 .yml 文件的共享链接?

如何解决如何为 Swagger 编辑器创建指向受保护 url 中的 .yml 文件的共享链接?

我将 Swagger online editor 用于我们的 API 项目文档。

项目本身托管在我们自托管的 Gitlab 实例中,受身份验证和权限保护。经过身份验证和授权用户的示例网址为

https://gitlab.company.local/team-name/project-name/-/blob/main/subfolder/api.yml

我们使用 Redmine 解决客户问题,因此它连接到 Gitlab 实例,并且也能够访问存储库文件。经过身份验证和授权用户的示例网址为

https://redmine.company.local/projects/project-name/repository/project-git/revisions/main/entry/subfolder/api.yml

现在我总是从文件中复制整个内容并将其粘贴到 Swagger 编辑器中以查看它。我们的 wiki 页面仅提供指向 .yml 文件链接用户必须手动将其复制到编辑器中。

如果 Redmine wiki 页面提供一个指向 Swagger 编辑器的 url,该编辑器从 Redmine 或 Gitlab 导入该文件(或其中之一能够为其提供显示),那就太棒了。

有没有办法自动执行以下步骤

  • 从 Swagger 编辑器针对其中一个系统进行身份验证
  • 从 url 导入 api 定义
  • 创建一个始终指向最新 API 文档的共享链接

也许有一个 Redmine 插件就是这样做的?基于链接的 .yml 文件显示 Swagger 编辑器。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。