问题标签 [flask-apispec]

我创建了一个非常简单的演示来演示返回值没有显示在 swagger-ui 中：

要求.txt

版本：

代码：

运行： http: //127.0.0.1 :3333/swagger-ui

为什么 Swagger UI 中没有显示返回对象？

我制作了简单的 Flask REST-API 应用程序。只有两个字段：

一切正常，图片上传，保存...... json 响应显示正常......但是，当我添加身份验证时，401 响应出现问题（'未授权'）。

奇怪的是，如果我只发布没有“照片”的“群组”，401 响应会正确显示。

我使用了这段代码：

然后我只是在帖子中调用它：

所以，如果我不发送“照片”，就会有回应：

但是在 POST 中使用照片时，缺少响应。

注意：如果我在标头中发送 X-API-KEY，一切正常。

这里有什么想法吗？

需要帮助来实施基于令牌的授权步骤和解决方案。我使用烧瓶作为后端和 html 和 CSS 前端。但是我很难找到关于 api 的最佳内容。我的目的是建立用户登录和注册

这是我的代码

#数据库 MySQL

我尝试大摇大摆地对我的应用服务进行分组。在我的项目中，我使用 FlaskApiSpec 为我的 Python-Flask 应用程序生成 Swagger 文档。

有一部分代码，我如何使用 Flask Blueprint 模式为我的应用程序生成 swagger 文档：

应用程序/初始化.py

应用程序/字符/views.py

结果是 在此处输入图像描述

我想将我的 /api/characters 方法大摇大摆地归为一组，并正确命名。我试着在网上找了很多东西，学到了一些关于标签的东西是Swagger。但我不明白，如何在 FlaskApiSpec 中使用此功能

我想可以在此处的某处添加标签：

但不明白怎么...

我注意到@use_kwargsinflask-apispec改变了响应内容类型。在以下“hello world”示例中，使用@use_kwargs将响应内容类型从 更改text/html为application/json。我觉得这有点令人惊讶，因为flask-apispec 文档 没有提到它，而且我不希望注入 args 也会改变响应类型：

curl -v http://127.0.0.1:5000/\?email\=abc shows the response

Note that the Content-Type: application/json and value hello world is quoted. However, without the line of @use_kwargs, the response is of Content-Type: text/html and the content hello world is not quoted:

What is the rationale of changing the response? How can I set the response content type of "text/html" even with the use of @use_kwargs? Thank you !

Update:

Just add a bit more details on the answer given by @Diego Miguel: The effect of changing content is caused by the logic in Wrapper.call

marshal_result calls flask.jsonify which makes a Response object with "application/json" mimetype and also introduces an extra level of quotation of the "hello world" example above.

我正在使用 apispec 来生成 openapi 规范（swagger），以便在 AWS 中进一步使用。

我试图通过创建另一个包含与实现的路由相关的文档字符串的函数的文件来优化我当前的文件。我仍然不确定这是否可能，但我确定它对我不起作用。到目前为止，这是我已经实现的：

文件login_file.py中login_doc()下面的函数包含与登录路由相关的文档字符串。

在文件generate_openapi.py我这样做了：

PS：其余的导入工作正常，只是在发布此问题时将其删除。

不幸的是，这对我不起作用。正如我之前所说，我试图尽量减少generate_openapi.py的代码行数，使其更具可读性和可理解性。提前感谢大家的时间。

我在 Python/Flask API 后端使用 apispec。我遵循了 apispec 文档示例中的格式。请参阅：https ://apispec.readthedocs.io/en/latest/ 谁能告诉我为什么我收到以下 json 架构和数据的验证错误？它说“响应”是必需的，但看起来它就在那里。结构不正确？任何帮助表示赞赏！

我正在尝试使用 PyYAML 的转储重现此 YAML 变量：

具体来说，这path_translation: [ APPEND_PATH_TO_ADDRESS ]是我无法生产的。

它旨在获取一个 python 对象并将其转换为有效的 yaml。问题是我只能得到

或者

从PyYAML 自己的文档看来，我正在尝试做的事情被称为“流集合”。但是当我尝试他们推荐的语法时，我只是得到了上面的结果，连字符代表一个列表项。

具体来说，我是在字典里做的：

任何关于如何正确产生这个的想法将不胜感激！

我使用flask-apispecwithwebargs来定义简单 API 的类型。我在下面制作了一个最小的示例，它重现了该问题，即kwargs对象为空。

服务器代码：

简单的客户端脚本：

为什么kwargs字典是空的？我看不出上面的内容与 flask-apispec 文档中的示例有何不同。

我正在尝试设置一个通过 POST 方法接受图像的 Web 服务。我正在使用 Python Flask 和 Flask-Apispec 创建 Swagger 文档。因此，我包含了这个 Marshmallow Schema 来定义接受哪些参数：

我现在还想记录只接受 png 图像并在 Marshmallow 中验证这一点。

因此，我尝试设置验证器

但是，此代码的控制台输出很简单

所以value只是一个内容为“[object File]”的字符串，而kwargs是空的。如何访问提交的文件以检查其名称？或者，我可以通过什么其他方式验证 Marshmallow 中的文件上传？