使用Open API 3.0.1定义API规范的swagger定义。但是，这里定义的响应示例GoodResponse不会被呈现。不过，语法似乎是有效的。如果有人指出我做错了什么，我将不胜感激 paths: post: - some-controller
operationId
浏览 126提问于2021-06-17得票数 1
回答已采纳
我创建了一个返回数组的项目。导入此swagger.json后，查看swagger.json一切正常。但是，当我从开发人员门户下载API定义时，我看到一些对象，如...Array、...数组-1、...数组-2。我没想到会这样： ? 我如何防止这种情况发生？如何才能确保生成的对象与正常对象的行为相同(所以没有虚线，而是点)。我创建了一个重现我的问题的示例项目：https:&#
浏览 14提问于2019-09-05得票数 0
回答已采纳
我们如何为任何响应对象定义多个示例。@ApiResponse(code = 200, response = Response.class, message = "Success", examples = @io.swagger.annotations.Example
浏览 20提问于2020-06-16得票数 0
我正在使用Swagger OpenAPI规范工具。我在其中一个定义中有一个字符串数组属性，如下所示： type: array type: string{ "Pune"}
如何为c
浏览 0提问于2017-10-05得票数 10
回答已采纳
因此，基本上我为API定义了swagger 2.0规范，并且在操作的响应上，我使用schema属性来引用反映响应结构的对象的一些定义。我在Swagger编辑器上验证了规范，它是有效的，而且如果我使用Swagger Codegen生成客户端代码，客户端应用程序在使用API时工作得很好。现在的问题是。我转到开发人员门户，在API的详细信息页面上，我检查了API定义(<
浏览 19提问于2018-08-23得票数 1
回答已采纳
我生成了第二个微服务，但是这次我已经在yml文件中定义了一个api，所以我选择了‘API’。我的api是使用open 3定义的，我使用成功地为我的api生成了代码，并使用curl测试了直接调用我的微服务端点:它在这一点上如预期的那样工作。我在搜索时发现的一件奇怪的事情是，当我直接调用我的微服务上的以下url时： (正如微服务的“欢迎页面”中指出的那样)，我得到了：
{"swagger":"2.0"
浏览 0提问于2019-01-13得票数 2
回答已采纳
这个库使用来实际将OpenAPI对象映射到OpenAPI模式。{ "info": {
"title": "OpenAPI如上所述，这意
浏览 1提问于2021-09-20得票数 1
1回答
我正在使用带有gRPC服务的protoc-gen-swagger生成swagger json文件。输出json是用空的响应示例生成的，我想将响应示例添加到定义中，以便在生成的json中自动填充。这是我目前的定义。service UserService { option (google.api.http) = {
浏览 59提问于2020-07-08得票数 1
回答已采纳
我从一个http请求得到以下形式的响应:它是一个由未命名数组和对象组成的数组。我找不出适合这种情况的Swagger (Open API)规范。
浏览 2提问于2017-12-11得票数 3
我想从一个swagger定义文件(yaml/json)生成一个示例请求和响应。其目的是将这些API存根出来。不幸的是，我没有管理员权限来安装swagger编辑器的generate server列表中列出的任何服务器框架。我还尝试用soapui(5.x)和ready api模拟它，但它们都不能解析定义文件的响应对象中的模式引用-例如： &q
浏览 1提问于2015-09-07得票数 5
1回答
我有一个API，它可以返回csv或json，在Accept头mimetype上进行降级。 Summary = "Freezing" .ToArray();这使得Swagger我的问题是，示例响应值的格式不是csv，
浏览 3提问于2022-04-27得票数 0
是否可以提供一个具有数组属性和字符串属性的对象的响应示例？我有以下OpenAPI 3定义： "200": { } }
浏览 7提问于2022-06-20得票数 2
回答已采纳
我对Swagger和open很陌生。我试图为一个对象创建一个模型(让我们说“包”对象)。 "channel": 0, "visibility": true但是，对于GET方法，响应包含
浏览 0提问于2018-09-08得票数 0
我正在编写一个自定义OpenApiConfigurator，它将一些示例动态添加到我的api中。当我使用作为对象的io.smallrye.openapi.api.models.examples.ExampleImpl，的value字段添加示例时，该示例在swagger中为null。要添加实际的json，我必须从我使用Jackson的响应中生成它。但是，如果无法在ObjectMapperCustomizer中使用夸克对象</em
浏览 6提问于2022-05-18得票数 1
回答已采纳
2回答
通过这种方式，我展示了整个文档(我使用的是mongoDb){ "message": "",我可以创建一个类，如：
export
浏览 12提问于2022-03-19得票数 2
3回答
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
像瓦拉格这样的人休息。
浏览 1提问于2015-07-31得票数 15
回答已采纳
3回答
我定义了我的傲慢定义如下： info: { version: '1.0.0', }, basePathin
浏览 2提问于2018-06-07得票数 4
回答已采纳
我正在尝试将我的API文档分解成多个可以独立编辑的JSON文件。我所能找到的所有示例都使用Swagger 1.2模式，它有一个"api":{}对象来分解它。这似乎是2.0模式()中缺少的。它所定义的就是一个单独的“路径”数组，它将所有的API端点绑定到这个数组中。这在swagger-ui中的效果是有一个单独的“默认”类别，所有的东西都被捆绑到其中，我无法告诉我如何将其拆分。TLDR:如何从
浏览 2提问于2014-11-14得票数 37
我试图使用swagger描述来验证REST的一些数据。我使用swagger编辑器转换选项将swagger.json转换为OpenAPI 3.0.1，现在使用以下代码行尝试使用ObjectMapper将其读取到OpenAPI对象中：(path); this.api$ref“、”$ref“、"d
浏览 4提问于2020-10-17得票数 0
回答已采纳
云服务器
ICP备案
云直播
实时音视频
即时通信 IM
腾讯云开发者
