openapi 相关问题

OpenAPI规范(最初称为Swagger规范)是用于描述,生成,使用和可视化RESTful Web服务的机器可读接口文件的规范。

自动生成的Node.js服务器无法启动(Swagger / OpenAPI)

我已经通过Swagger Editor生成了一个nodejs-server,但是当我运行“npm start”时,服务器没有启动并且没有返回任何错误。我第一次运行“npm start”已经安装了所有依赖项,但“......

回答 1 投票 0

如何从现有的Spring Boot App生成OpenApi 3.0规范?

我有一个项目(Spring Boot App + Kotlin),我希望有一个Open API 3.0规范(最好是在YAML中)。 Springfox库很不错,但它们生成了Swagger 2.0 JSON。是什么 ...

回答 1 投票 1

如何在Swagger(OpenAPI)中发布文件?

我使用Swagger来记录我的REST服务。我的一项服务需要上传CSV文件。我在JSON API定义的参数部分添加了以下内容:{“name”:“...

回答 3 投票 45

OpenAPI数组内的多种类型

我在使用OpenAPI 3定义可重用的模式组件时遇到了麻烦,因为OpenAPI 3允许包含多种类型的数组。每个项类型都继承自同一个父类,但具有特定的...

回答 1 投票 2

Django REST框架Swagger 2.0

很难配置Swagger UI以下是非常简洁的文档:https://django-rest-swagger.readthedocs.io/en/latest/ YAML docstrings已弃用。有人知道如何配置......

回答 4 投票 18

如何在OpenAPI / Swagger中递归引用封闭类型定义?

我正在Swagger编辑器中编写OpenAPI定义。我的一个类型定义包含一个包含与父类型相同类型的子元素的数组。即像这样的东西:定义:......

回答 1 投票 7

从外部yaml文件引用响应时的NPE

我正在分割YAML文件,但是我在生成代码时遇到以下异常:java.lang.NullPointerException at io.swagger.v3.parser.ResolverCache.updateLocalRefs(ResolverCache ....

回答 1 投票 1

Swagger UI上不显示“请求正文”

我正在尝试使用我的Swagger文档上的POST请求进行测试,但是我遇到了以下问题:在Swagger编辑器上我可以正常测试它,但在Swagger UI上,Request body字段没有...

回答 1 投票 0

如何在几乎所有路径中复制粘贴3个通用错误响应?

我希望我的几乎所有路径都有以下3个通用错误响应。我怎么在Swagger中描述它,而不是在任何地方复制这些行? 401:描述:请求者是......

回答 2 投票 8

Swagger 3.0.0 codegen失败java.lang.RuntimeException:缺少swagger输入或配置

我使用swagger指定我的API我正在使用2.0现在根据我使用离线swagger编辑器指定3.0.0规范的文档有新版本3.0.0。一旦准备就绪......

回答 1 投票 2

Swagger 3.0架构错误“不应该有其他属性”

下面这个错误是什么意思? (在Swagger编辑器中运行)模式错误不应该有其他属性additionalProperty:/ buildinfo,/ clearcache,/ countries / {countryId} / cinemas / {...

回答 1 投票 2

如何在Swagger UI中使用OpenAPI 3.0响应“链接”?

我正在编写一个Open API 3.0规范,并尝试在Swagger UI v 3.18.3中获取渲染的响应链接。示例:openapi:3.0.0 info:title:测试版本:'1.0'标签: - name:Artifacts paths:/ ...

回答 1 投票 2

如何使用JSON为OpenAPI绘制表

我想在JSON文件中创建一个表,我使用Swagger UI(2.0)来描述API。 opneapi.json托管在Gitlab中。 Swagger规范说GFM语法可以用于富文本表示....

回答 1 投票 2

Java - 如何直接从openapi 3.0规范生成Swagger UI

我有yaml格式的openapi 3.0规范和我的应用程序,它从中生成代码。一切都很好,除了一代的招摇ui。我用spring-fox代替它,但似乎......

回答 1 投票 1

从YAML OpenAPI规范中删除字段

我需要从我的OpenAPI规范中的每个方法中删除tags字段。规范必须采用YAML格式,因为转换为JSON会在以后发布时导致问题。我找不到准备......

回答 1 投票 1

是否有OpenAPI v3 Petstore示例

我一直在使用https://editor.swagger.io/设计一个API。我一直在使用的这个平台是Swagger版本2,我注意到现在已经被OpenAPI 3取代了。是否有相同的“......

回答 1 投票 0

我可以生成Open API 3 Python Flask服务器吗?

从http://editor.swagger.io/和swagger 2.0我可以选择:生成服务器 - > python-flask并生成一个我可以部署和使用的python服务器。但当我改为使用OpenAPI v3时......

回答 1 投票 0

如何从现有的falcon api生成Open API规范?

我有一个用Falcon框架编写的现有RESTful API。目前,我使用Sphinx进行API文档。我想切换到Swagger(现在称为OpenAPI)并生成Swagger规范......

回答 1 投票 0

使用Python进行OpenApi 3请求验证

似乎有许多python库专门用于验证OpenApi架构的正确性。虽然这可能有用,但我可以坦率地在https://中编写我的OpenApi模式。

回答 2 投票 2

Swagger jsdoc不会立即更新apidocs的变化?

我正在使用swagger-jsdoc我在app.js中设置了如下所示的swagger js文档// include swagger js doc var swaggerJSDoc = require('swagger-jsdoc'); const swaggerUi = require('swagger-ui-express'); ...

回答 1 投票 1

© www.soinside.com 2019 - 2024. All rights reserved.