问题标签 [flasgger]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
45 浏览

python - 未描述Flasgger标头参数

我尝试使用 flasgger 为项目实现 swagger 文档。当我描述正文字段时 - 它工作正常,但是当我尝试描述标题字段时,flasgger 不会在网络上显示参数的描述。

flasgger 的 .yml 文件示例。

而且,这是我在网上看到的: 在此处输入图片描述

我应该遵循什么结构的 .yml 文件来获取标头中描述的会话令牌以及正文参数?

0 投票
1 回答
204 浏览

python - 具有多个规范的外部 YAML 不适用于 Flasgger

我试图通过引用同一个 YAML 文件来记录多个端点,但它不起作用。这不支持吗?还是我做错了什么?

应用程序.py

颜色.yaml

预期结果

具有完整规范(示例、响应、参数等)的两个端点,就像 README 中的屏幕截图中的规范一样。

实际结果

规格不完整,缺少很多细节:

图片

0 投票
0 回答
44 浏览

python - 当主机名有路径时,Flasgger 不加载

我有一个 Flask 应用程序,并且我已经为文档集成了 Flasgger。当我在本地运行我的应用程序时,我可以在http://127.0.0.1:5000/apidocs. 但是当它部署到我们的开发环境时,主机名是https://services.company.com/my-flask-app. 当我/apidocs在该 URL 的末尾添加时,不会加载 swagger。

这就是我配置招摇的方式:

当我运行它时,我可以在本地访问 swagger http://127.0.0.1:5000/my-flask-app/apidocs/#/,但我认为在我的开发环境中它可能可以在https://services.company.com/my-flask-app/my-flask-app/api-docs. 当我检查控制台时,Flasgger 尝试从https://services.company.com/nothttps://services.company.com/my-flask-app

关于如何解决这个问题的任何想法?

0 投票
0 回答
78 浏览

python-3.x - 为什么 flasgger 使用 localhost 而不是我部署的服务器?

我正在使用 python 烧瓶应用程序和使用 flasgger 的 API 文档。当我在本地运行我的烧瓶应用程序时,http://localhost:8086/swagger/我得到了正确的招摇用户界面。

现在我们已经使用Nginx前端服务部署了我们的应用程序。当我们调用已部署的链接时http://localhost:8086/api/core/swagger/,我们会看到一个空白的白色页面,页面Powered by Flasgger 0.9.5右上方。

在 Web 开发人员工具控制台中,我收到此错误。

我知道这可能是 flasgger 尝试加载 CSS 文件或其他资源的一些问题,并且无法正确呈现。因为某条路

在我配置 swagger 的过程中,我有以下配置功能。

并且我在其中的所有其他端点api.py都遵循此架构。

healtz.yaml我的文件样本:

此 YAML 文件位于项目中,目录名为Swagger.

我已经浏览了以下答案,但没有得到答案。

对于部署,我们使用我们拥有容器的 EKS 服务。

为什么会出现这个问题?有人可以帮我写代码吗?