我有一个OpenAPI 3.0模式，其中一个属性( taskRequireSkills数组)需要引用另一个模式(TaskRequireUserSkill)，如下所示： schemas
浏览 3提问于2020-03-11得票数 0
回答已采纳
我很难弄清楚如何在OpenAPI 2.0中嵌套模型。但是，使用数组可以很好地工作： type: array $ref: OtherModel
浏览 0提问于2014-10-10得票数 14
回答已采纳
假设我有一个OpenAPI swagger.yml文件，它看起来像：info: version: '1.0' properties: type: string
我更喜欢将真相模式的来源保留在我的模式/目录中，例如，sch
浏览 4提问于2022-02-15得票数 3
1回答
我的OpenAPI规范文件有问题。我试图调用一个公开的url来‘获取’一个id，但是每次我将服务转发到我的本地，然后尝试通过API文档发送请求时，我的连接就会被拒绝。我很感谢你的帮助。下面是我的规范文件info: title: Id Generator url: www.someurl.com
浏览 4提问于2017-06-20得票数 1
回答已采纳
2回答
不幸的是，Swagger 2.0似乎对输入和输出的模式非常严格，并且不允许JSON Schema所允许的整个模式集。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。因此，我尝试通过定义一个MixedValue模式来解决这个问题：swagger: '2.0' version: 0.0.1consumes-我可以期待swagger为我的API规范中</e
浏览 2提问于2015-09-29得票数 9
回答已采纳
2回答
我在XSD文件中有一些模型定义，需要从OpenApi定义引用这些模型。手动重塑是不可行的，因为文件太大了，我需要把它放到一个构建系统中，这样如果XSD发生了变化，我就可以为OpenApi重新生成模型/模式。我尝试过并且几乎成功的方法是使用xsd2json，然后使用节点模块json-schema-to-openapi对其进行转换。然而，xsd2json正在放弃一些complexElement型号。例如，在一个模型中使用"$ref&qu
浏览 34提问于2019-05-07得票数 9
回答已采纳
我使用Google来构建GCP端点，它依赖于openapi-run.yaml来定义API。我有一个大的JSON模式文件，我想在openapi-run.yaml中引用该文件 get:
summary: test for Reference--project myProject时，它会给我一个错误："OpenAPI spec in file {openapi-run.yaml} is ill formed an
浏览 5提问于2021-02-08得票数 0
似乎有许多用于验证OpenApi模式正确性的python库。虽然这可能很有用，但坦率地说，我可以将我的OpenApi模式写在中，并对其进行验证/转换/格式化。然后，客户端可能会向我的OpenApi文档的端点发送任何类型的脏数据。目前，根据OpenAPI模式验证数据的问题通常通过使用插件扩展数据验证工具来解决，这些插件可以从数据验证声明中推断出OpenAPI规范。但是，通常不可能出
浏览 0提问于2019-02-18得票数 13
1回答
嗨，我正在寻找一种通过OpenApi3模式定义版本控制的方法，在OpenApi2中，您有basePath参数，这个参数在OpenApi3中不再存在。我正在使用SpringBoot，我们使用生成器从模式生成端点。我想在全球的某个地方添加版本参数，使端点url像www.server.com/v1/终结点.在OpenApi3模式中，
浏览 3提问于2020-03-20得票数 0
FastAPI中的FastAPI端点存在问题，该端点通过单个查询参数接受字符串列表。使用此端点的一个例子是：在这里，名为'response‘的参数接受一个字符串列表，如FastAPI教程中关于的部分所记录的那样。端点在浏览器中按预期工作。但是，它在Swagger文档中不起作用。标记为‘’的按钮在</
浏览 9提问于2022-03-18得票数 4
回答已采纳
我正在IntelliJ中编辑一个JSON规范。自动验证和代码完成工作非常好。
使用的OpenAPI版本为3.0.3，IntelliJ正确检测。但是，所引用的文档不被识别。如何告诉IntelliJ，该文件是OpenAPI规范的一部分，将作为OpenAPI规范进行验证？人们应该认为这可能是从主规范开始的$ref'ed推断出来的，但这是行不通的。试图在引用的文件中添加$schema值没有效果(而且可能与O
浏览 10提问于2022-02-09得票数 1
回答已采纳
在内部，我定义了模式，并将所有公共定义放在公共模式中，并在需要时将本地资源$ref添加到这些定义中。现在，用户将使用这些模式来发送适当的有效负载，并且我已经定义了get模式apis来返回这些模式。但是，当我从netorknt schema validator获得模式时，它是按照$ref原样定义的。这对于用户检索多个模式并手动查看公共模式中的defs以了解其定义是非常不方便的。我想检
浏览 30提问于2021-09-29得票数 2
我目前正在寻找从大型OpenAPI规范中提取所有JSON模式。我一直在使用以下NuGet包：我希望使用这些来解析大型Open规范并提取所有JSON模式，我能够将这些模式解析为“Microsoft.OpenApi.Models.OpenApiSchema”对象。，但我似乎无法确定下一步如何将其从
浏览 20提问于2022-04-21得票数 3
回答已采纳
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: string
但这不允许数组中</em
浏览 2提问于2016-08-01得票数 14
回答已采纳
2回答
在有关参数序列化的OpenAPI文档中，有一个关于如何序列化具有不同样式的查询、路径、头和cookie参数的简短章节。这些参数的模式被描述为OpenAPI风格的json模式，它允许无限嵌套对象和数组。关于如何在文档中处理这些问题，我还没有发现任何提及：
{ "propert
浏览 10提问于2021-05-28得票数 2
回答已采纳
我正在尝试使用swagger-codegen为模式规范生成Java客户端。该模式使用供应商扩展x-discriminator-value创建继承模型。例如，我使用了我作为yaml 找到的模式规范，并将其转换为json (我用"spec“根将结果包装起来，这样我就可以将结果发送到在线代码生成器，如下文后面所述)。当我尝试在本地或使用在线代码生成器生成Java时，我会发现，没有使用x-discriminator-value值完成去角色化。相反，它是用模型名来完成的。我在生成的JSON.java文件中看到了这一点，该文
浏览 16提问于2020-01-29得票数 1
回答已采纳
在OpenApi模式中，它包含选项元素OperationId。我的猜测是，它与SDK的使用方式有关。例如:我可以从任何有效的OpenApi模式生成Typescript SDK ...所以我猜它以某种方式与Typescript SDK是如何生成的，然后使用/使用的？
浏览 27提问于2020-03-14得票数 0
我想描述使用JSON返回的JSON，引用我的OpenAPI配置文件中的模式。编辑:在文章末尾看到一个(希望)更清晰的例子。“根模式</e
浏览 3提问于2020-09-21得票数 1
回答已采纳
云服务器
ICP备案
云直播
实时音视频
即时通信 IM
腾讯云开发者
