如何为 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 (将#修改为@)