当前位置: 首页 > 知识库问答 >
问题:

带有我自己的yaml文件的swagger API文档

祁永嘉
2023-03-14

我有我的API文件与大摇大摆。为了方便开发人员,我想在我的网站上提供的招摇过市的图形用户界面以及。但是,我的提供商尚未安装php yaml扩展。这意味着我不能在自己的网站上使用GUI。

所以,我想使用第三方GUI。我知道我可以使用https://petstore.swagger.io/,并在文本框中输入到我的yaml文件的链接。这也不是真正的用户友好。我更喜欢在调用url时打开GUI并指定yaml。对于用户,GUI以我的API定义打开。

有什么想法吗?

共有1个答案

司寇善
2023-03-14

如果出于某种原因,您自己无法主持Swagger UI,以下是一些您可以尝试的替代方案:

>

使用GitLab托管OpenAPI YAML/JSON文件。GitLab使用Swagger UI渲染OpenAPI文件。示例:
https://gitlab.com/gofus/gofus-api/blob/dev/swagger.yaml

使用https://petstore.swagger.iourl查询参数自动加载API定义:

https://petstore.swagger.io?url=https://yoursite.com/api.yaml

为此,承载OpenAPI文件的服务器必须使用HTTPS并支持CORS。

 类似资料:
  • 我在这里找到了一个非常简洁的链接来托管Swagger用户界面中的yaml文件,但是它使用了Springfox而不是Springdoc,所以我想知道是否有任何其他类似的方法,因为我的公司更喜欢后者。 我真的很感激任何帮助,只要有个导游就可以了。

  • 我在这方面遇到了很多麻烦。我定义了构造函数,我可以让它导入一个文档,但不是两个。我得到的错误是: 有了一个include,Snakeyaml很高兴找到一个EOF并处理导入。有了两个,就不开心了(上图)。 我的java源代码是: 问题是,有没有人对蛇蟹做过类似的事情?有没有想过我做错了什么?

  • 问题内容: 我有一个yaml文件,看起来像这样: 有没有一种方法,我可以和这个数据,同时保持有何评论? 问题答案: PyYAML丢弃了非常低的注释(以中)。 尽管您可以调整或扩展它以处理整个堆栈中的注释,但这将是一个重大修改。发出(=发出)注释似乎更容易,并且在旧的PyYAML错误跟踪器的故障单114中对此进行了讨论。 截至2020年,有关增加对加载评论的支持的功能请求仍处于停滞状态。

  • 我试图在团队将websphere配置文件设置为活动状态时实现云配置文件也被激活。 yaml文件 当我设置时,我收到以下错误

  • The Python Imaging Library uses a plug-in model which allows you to add your own decoders to the library, without any changes to the library itself. Such plug-ins usually have names like XxxImagePlugi

  • 在我的11ty站点(skeleventy-starter)上,我想解析数百篇评论。这些评论被存储在我的数据文件夹中的一个名为reviews的文件夹中,作为单个YAML文件(名称如下:“entry-7128372832.yml”)。每个yaml文件如下所示: 但是,当我尝试在我的.njk文件中遍历review-data时: 我似乎既没有访问数据的权限,也没有在控制台中得到一个错误。我错过了什么?感谢