我正在使用DarkOnLine的L5 Swagger来生成使用OpenApi schematics的Swagger文档。要使用模式，我可以做到 @OA\Property(property="certification", type="array", @OA\Items(ref="#/components/schemas/但它会创建一个带有方括号的数组块，其中包含多个
浏览 28提问于2019-01-29得票数 3
回答已采纳
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: string
但这不允许数组中的整数是否有方法定义混合类型<em
浏览 2提问于2016-08-01得票数 14
回答已采纳
1回答
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。: binary 使用上面的定义，swagger代码生成器生成一个接受byte[]数组作为主体字段new Job().setBody(new byte[1])的对象。在将API定义转换为OpenAPI之后，该对象的定义保持不变，但是openapi代码生成器现在需要org.springframework
浏览 62提问于2020-07-08得票数 10
回答已采纳
我正在开发一个应用程序，它使用库为其Spring控制器生成OpenAPI v3端点。这个库使用来实际将OpenAPI对象映射到OpenAPI模式。没有类型的架构与任何数据类型匹配--数字、字符串、对象等等。object类型，而不是任意类型。在使用自定义使用带有空type的Swagger 时，我发现了一件事：Swagger Core最终将类型转换为
浏览 1提问于2021-09-20得票数 1
2回答
我正在为其编写Swagger 2.0规范的API基本上是任何JSON值的存储。不幸的是，Swagger 2.0似乎对输入和输出的模式非常严格，并且不允许JSON Schema所允许的整个模式集。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。因此，我尝试通过定义一个MixedValue模式来解决这个问题：swagger: '2.0'
浏览 2提问于2015-09-29得票数 9
回答已采纳
在创建我的模型之后，我将在swagger中测试它们。现在，我遇到了使用“oneOf”作为我的参考的问题。如下所示。有谁可以帮我？
浏览 5提问于2017-11-22得票数 1
Swagger & Swagger交替使用“模式”和“模型”。我想将它们称为Swagger实例(而不是模式)上的模型，但无法找到在哪里进行此更改。
我已经附上了两个图片，显示我指的地方。我希望从页面中删除所有对“模式”的引用，并将它们替换为“模型”，类似于它们创建的Swagger的许多测试站点(例如：)上出现的“模式”。
浏览 2提问于2022-09-20得票数 1
回答已采纳
1回答
我希望将其作为自动构建(最好使用Gradle)的一部分来完成，这样我就可以创建服务接口，并将接口的实现作为自动化过程的一部分。这个工作示例展示了如何做到这一点，但是它使用了Swagger2.0规范YAML：错误是：
在[来源：(字符串)“openapi: 3.0.0 ]处读取com.fasterxml.jackson.core.JsonParseException:未识别的令牌'openapi&#x
浏览 6提问于2020-01-23得票数 10
回答已采纳
3回答
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
像瓦拉格这样的人休息。
浏览 1提问于2015-07-31得票数 15
回答已采纳
我试图使用Swagger来定义接受实际文件的API和描述文件内容的模式对象。这是“摇摆YAML”的一个片段。但是，它不会在Swagger中验证。in: formData required: trueSwagger编辑器引发以下验证错误：
我是不是遗漏了什么？或
浏览 6提问于2015-09-22得票数 7
1回答
我在IBM中看到了一些SDK，用于语音到文本，但没有看到像JSON这样的OpenAPI 2.0 (Swagger)文档。我们得用在我们的案子里。那是真的吗？
浏览 3提问于2020-10-15得票数 0
回答已采纳
1回答
在node.js，我刚刚开始使用swagger，我想将参数--我使用'joi‘创建的验证模式--与swagger集成。swaggerAutogen(outputFile, endpointsFiles, doc);const { swagger, components } = j2s(postVersionInfo
浏览 14提问于2022-02-06得票数 1
我试图使用swagger描述来验证REST的一些数据。我使用swagger编辑器转换选项将swagger.json转换为OpenAPI 3.0.1，现在使用以下代码行尝试使用ObjectMapper将其读取到OpenAPI对象中：externalDocs“、"maxLength”、"writeOnly“、"uniqueItems"，“属性”、"maxPropertie
浏览 4提问于2020-10-17得票数 0
回答已采纳
5回答
有一些很好的工具可以针对JSON进行验证，但是我没有机会找到一个工具来验证在Swagger (用于创建API模式的工具)中创建的规范。我找到的唯一解决方案是在Swagger中生成一个客户机/服务器，它非常麻烦。
是否已经有了针对Swagger验证JSON的现有工具？
浏览 6提问于2016-09-01得票数 66
回答已采纳
2回答
使用OpenApi的实际优势是什么？
我是openApi技术的新手，我只是想知道在openApi中有哪些特性比在swagger中有更多的特性。网上文件帮不了我。有人能帮我吗。
浏览 2提问于2020-04-03得票数 9
回答已采纳
2回答
我使用OpenAPI 3.0.0并希望在requestBody中传递一个Items数组作为参数。Item: properties: type: string type: string以及请求体模式如下：为什么它显示的是顺序图而不是我的普通对象？有人能告诉我如何做规范正确的<em
浏览 1提问于2018-01-30得票数 0
回答已采纳
有没有一个生成器可以把OpenAPI 3.0转换成Swagger2.0？
Mashery是一个API网关，它需要Swagger 2.0格式的输入才能打开端点。
浏览 26提问于2019-06-18得票数 49
回答已采纳
API-Platform将生成Swagger/OpenAPI路由文档，然后生成模式(AKA模型)的以下文档( docs将它们显示为“模型”，但当前版本如2.7将它们显示为“模式”)。生成的用于显示这些模式/模型的内容在哪里？如何删除其中的一些？显示它们的功能是Swagger-UI的一部分，但API-Platform必须负责提供JSON配置，从而更改API-Platform而不是Swagger-UI。请注意，this
浏览 33提问于2021-06-24得票数 0
给出以下OpenAPI定义 required: type: object id:下列哪一个对象是有效的上的JSON模式验证器说，2.无效，因为null不满足type: string约束。注意，它不会因为id是null而抱怨，而是因为null不是字符串。但是这对OpenAPI/Swagger有多重要呢？
浏览 1提问于2017-08-08得票数 55
回答已采纳
我正在尝试使用DRF的Open API + Swagger UI来实现AutoSchema文档。 我想要做的是指定一个基本url，以便schema和swagger只显示资源(端点)。'), template_name='swagger-ui.html',
extra_context={'schema_url': '<e
浏览 12提问于2020-12-18得票数 0
云服务器
ICP备案
云直播
腾讯会议
实时音视频
腾讯云开发者
