问题标签 [swagger-node]

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 回答
742 浏览

swagger - 如何设置我的 swagger-node 路由以接受任何内容类型?

目前,我将 Swagger YAML 设置为application/json默认接受每个路由,在顶级 Swagger 定义中具有以下内容:

我现在有一个可以返回文件的路由,我不想指定所有可能返回的潜在文件。我在 Swagger GitHub 页面上看到,可能有某种通配符允许返回任何内容类型。我在我的路线中尝试了以下方法:

但是 Swagger UI 不允许我在 UI 中发送请求,因为它认为这没有Accept填充字段。

然后:

但是 Swagger UI 会抛出一个错误,指出unidentified alias "/*". 我也尝试过\*/*,以防万一这与需要逃脱有关,但这没有用。

最后:

这个允许我在 Swagger UI 中测试路由,但响应仍然未能通过验证,并声称预期的内容类型仍然是application/json.

是否有通配符有效,或者我是否正在尝试做一些 Swagger 没有设置的事情?

0 投票
0 回答
347 浏览

cookies - swagger 中不存在 cookie 标头?

0 与 express-session 但我无法发送 cookie,即 header.its 中的 session.sid 显示在 curl 但它没有显示在服务器中。那么任何人都可以帮助我如何设置它?

0 投票
1 回答
464 浏览

node.js - swagger-node: 使用 swagger "project edit with" $ref (多个文件)

我正在检查招摇节点。这似乎是一些基本的东西,所以我很难相信这是一个错误。

我使用 .swagger-node git 页面创建示例 swagger hello worldswagger project create hello-world项目

我使用$ref具有相对路径的外部文件,但无法打开该文件。使用控制台,我可以看到它尝试了一个请求,但出现了 404 错误。看来 swagger 编辑器只能访问 swagger.yaml 文件,而不能访问其他文件。

作为测试,我将引用的 hello.yaml 文件复制到项目的每个文件夹中,但仍然得到Reference could not be resolved: hello.yaml

招摇的.yaml

你好.yaml

0 投票
1 回答
120 浏览

swagger - OpenAPI 设计优先 API 参考

我正在尝试使用 OpenAPI 格式 (v2) 记录 REST API 参考。我希望它是“设计优先”的,这意味着我的招摇规范将成为 API 实现的合同。

我已经尝试了许多模块和解决方案,例如swagger-node(对文件夹结构和实现过于依赖),swaggerize -express迫使我使用 express 等。我还尝试了generator-openapi-repo,但它似乎已经过时并且不再维护.

有什么解决方案可以记录 REST API 参考、设计优先且不将文档与实际实现结合起来吗?

0 投票
0 回答
102 浏览

swagger-node-express - 将调试器附加到 swagger 节点

我有一个节点招摇项目,使用:

我正在使用 webstorm,并且正在尝试将调试器附加到我的源代码中。控制器代码,但我不能。有人可以帮忙吗?我尝试了 30 种不同的东西,但我无法让它发挥作用。

0 投票
0 回答
338 浏览

node.js - Swagger-node - 捕获 multer “Unexpected Field”错误

我正在为一个涉及上传文件的小项目使用 swagger-node v0.7.5。

要上传的文件已在 YAML 文件中声明,并且可以按预期工作,但是由于出现以下问题,我无法解决。

如果客户端发送未在 YAML 中声明的额外文件字段(“意外字段”),我会在控制台中收到以下错误,并且还会作为 500 错误发送给客户端:

我希望能够忽略客户端发送的未在 Swagger YAML 中声明的任何字段/文件。

招摇的.yaml

控制器:import_xsd.js

0 投票
1 回答
1316 浏览

node.js - 节点请求实体太大 body-parser 限制设置

我确实有一个 Node 后端,它通过以下方式为我的反应前端提供服务

正文解析器限制由

如果我让它在我的本地机器上运行它就可以工作。

现在我已经将它部署在服务器(Ubuntu 16.04.4)上,我收到错误消息 413 request entity too large nginx/1.10.3。我有点困惑,因为 nginx 甚至没有安装。我还尝试通过将 client_max_body_size 添加到 nginx.conf 和 /sites-enabled/default 配置文件来安装 nginx 并调整配置,但我仍然收到相同的错误消息。

知道 413 错误还有什么问题(正如我所说,如果它在我的本地 Windows 机器上运行但不在 ubuntu 服务器上运行,它可以工作)

编辑:我尝试安装 nginx 并调整设置,如下所示,但我仍然得到同样的错误......

0 投票
1 回答
464 浏览

swagger - 如何使用 swagger-ui-express.serve 并在回调函数 Nodejs 中设置 swagger 文档

而不是这个,我想使用NodeJS的内部回调函数需要在回调函数内部动态设置basepath。

请帮我解决这个问题..