我想为REST POST服务创建YAML模式。type: object - address - type 如何指定只有当type字段值=“identifier”时，大字段才是必填字段？或者也许identifier字段不应该在请求列表中，相反，我应该在某个地方添加一些注释，让第三方知道api要求？
浏览 113提问于2018-12-19得票数 2
根据亚马逊网络服务文档，API Gateway中的模型支持JSON Schema语法，然而，它们导出为Swagger OpenAPI规范，而Swagger规范并不完全支持许多有效的JSON Schema我希望我的API Gateway模型有一组可选的文本字段，例如message，但当定义为 "type": "object", "message": {即使message未包含在
浏览 2提问于2017-05-12得票数 2
我正在使用Swagger编辑器生成YAML/JSON代码，这些代码将在Swagger UI中显示我的API的详细信息。我希望我的API的使用者能够查看修订历史记录(例如添加的字段、从“可选”更改为“必填”的字段等)。Swagger是否支持此功能？
浏览 7提问于2015-08-04得票数 4
4回答
我花了很多时间试图找到一种在Node.JS中创建swagger文档的解决方案，主要的库是swagger-node，在这个库中你可以创建一个swagger yaml文件，然后将你的控制器添加到这个文件中它会自动在你的应用程序中提供swagger ui文档，并根据你在yaml中指定的模型对请求和响应进行验证。这很巧妙，但是我有一个要求，我希望某些字段能够显式地返回或接受null作为值，例如： { description: "string
浏览 51提问于2016-07-01得票数 17
回答已采纳
我在nodejs应用程序中有一个swagger.yaml文件，如下所示x-swagger-router-controller: User tags在我的用户控制器中验证subData，例如下面给出的代码var fs = require('fs')try{
swaggerObject = <
浏览 1提问于2018-04-22得票数 1
因此，我希望在不降低swagger库版本的情况下生成swagger 2.0YAML文件(api端点已经使用swagger 4.x - openapi 3.0规范进行了描述)。"@nestjs/swagger": "^4.5.4",import * as fs f
浏览 42提问于2020-06-19得票数 2
回答已采纳
1回答
我试图在我的swagger.yaml项目中使用go-swagger自动生成golang文件。我理解之间的区别。下面是和单独文档的链接。
浏览 9提问于2022-04-14得票数 1
我想知道在node.js中学习swagger所需的先决条件是什么，以及swagger在node.js中的作用是什么。我需要学习YAML吗？
浏览 1提问于2016-10-05得票数 1
回答已采纳
不幸的是，我还没有找到使用已经生成的开放API规范文件的path的方法。app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger&
浏览 3提问于2021-04-27得票数 1
我不想在两个地方维护我的服务器规范，也就是说，我不想同时维护proto文件(.proto)和swagger规范(.json/.yaml)。由于我绝对需要编写proto文件来生成gRPC服务器，所以我想要自动生成swagger规范(OpenAPI3)。我所处的位置：
我能够使用swagger库(如： )从protobuf文件(.proto)生成.proto规范。(3)从.proto转换到OpenAPI3规范(.yaml
浏览 4提问于2020-04-21得票数 11
2回答
我在swagger.yaml中定义了REST。里面有所有的字段及其规格(例如:长度、图案等)。在java中是否有一种方法可以根据这些字段的规范来验证它们，而不必手动进行呢？
浏览 3提问于2021-09-02得票数 0
回答已采纳
我在yaml文件中标记了这些字段(swagger ) type: object - name我使用的是swagger codegen maven插件，配置如下：<version>2.2.3</version>
<langua
浏览 0提问于2018-04-02得票数 9
回答已采纳
1回答
我有一个spring引导应用程序，它从2个规范文件中生成2个API。我可以为其中一个生成swagger-ui页面，方法是添加敬application.properties。我试过：这创建了一个组合的http://localho
浏览 4提问于2020-08-31得票数 1
回答已采纳
1回答
我有一个Java3.0规范( YAML格式)，希望为OpenAPI生成代码。这个工作示例展示了如何做到这一点，但是它使用了Swagger2.0规范YAML：错误是： repositories { } classpath("
浏览 6提问于2020-01-23得票数 10
回答已采纳
我正在尝试为C#/asp.net核心生成客户端代码，以使用具有swagger 1.1规范的服务。(服务不在我的控制范围之内)。不幸的是，大多数最新的工具需要的是swagger 1.2规范。
浏览 65提问于2018-12-06得票数 1
我正在尝试使用Swagger为我用golang编写的REST API创建文档。我一直遵循这个指南：这样做，并且已经能够从我的主文件中的注释创建json文件，但是我不知道如何创建.yaml文件，以将其转换为实际的swagger规范。我已经按照页面上的说明进行了操作，并将//go:generate swagger generate spec包含在我的主文件中。有人知道如何创建.yaml文件吗？
浏览 4提问于2016-06-01得票数 7
回答已采纳
我试图在“Model”选项卡和“示例值”选项卡中为带有可选对象的swagger.yaml对象提供更多的描述 mymodel尽管我的模型不要求任何字段，但我希望它用示例显示这些可选字段。我仍然是YAML规范的新手。
浏览 13提问于2017-06-09得票数 2
回答已采纳
我使用Node.js和Swagger来构建restful。Swagger (这里的演示链接)需要一个JSON。
如何根据Swagger规范yaml文件生成这个提要？难道没有一个npm模块可以迭代yaml文件并生成JSON提要吗？我是斯威格的新手，所以我可能忽略了一些东西。
浏览 21提问于2015-07-26得票数 4
回答已采纳
有很多与Swagger相关的编码器可以将YAML转换为HTML文件，但是有没有eclipse插件可以打开YAML或将YAML转换为HTML？我已经在多个地方搜索过了，但是没有一个地方可以找到像Yedit这样的插件.Plugins，它能帮助我们看到一个颜色语法形式的YAML，而不是一个超文本标记语言？
浏览 0提问于2016-11-11得票数 0
我有一个OpenAPI规范，并且我已经使用openapi-generator来生成Golang gin服务器。谢谢。
浏览 2提问于2021-02-24得票数 1
云服务器
ICP备案
云直播
对象存储
实时音视频
腾讯云开发者
