如果我要使用像AutoRest这样的客户端生成器，我是否希望生成的客户端预期500个错误？这只是一个我需要做出的风格决定吗？
浏览 1提问于2017-07-19得票数 1
回答已采纳
5回答
我继承了一个现有的API，我想用swagger来记录它，但我还不知道它的全部范围。Swagger (或其他中间件/工具)是否可以基于现有的express路由自动生成yaml (用于swagger)？对于我在其他问题上看到的，这似乎主要是一个手工工作，但我正在仔细检查这里是否有人找到了解决这个问题的方法。
浏览 2提问于2015-07-09得票数 55
我创建了一个简单的谷歌云函数，并想。它说我需要编辑openapi.yaml文件。我找不到它。
在哪里可以找到谷歌云项目的openapi.yaml文件？
浏览 9提问于2020-05-26得票数 1
回答已采纳
我正在为我的API端点实现集成测试。为了验证json响应模式，我使用了swagger文档。通常，我必须将swagger转换为json并手动创建Json模式文件。我发现所有的技巧信息都是在swagger文件中定义的，它应该有一些方法可以直接从swagger文档验证json响应。
浏览 1提问于2018-04-03得票数 0
回答已采纳
我正在使用来记录我的web api项目，我不能为前置条件失败的情况添加多个响应，swagger只显示最后一个。</response>{ }, "description": "
浏览 2提问于2016-03-23得票数 1
1回答
我已经通过在pom.xml中导入open API依赖项创建了一个API规范文档，但在生成的swagger UI界面中，我的架构仅适用于200个响应。我是否需要手动添加其他响应，或者swagger可以自动生成它
浏览 37提问于2021-09-23得票数 0
1回答
我对Java很陌生。我正在开发一个使用openapi2.0的遗留应用程序。我添加了一个带有两个api端点的新控制器。这两个api端点并没有出现在swagger中。我看到了openapi.json中现有端点的条目。我正在尽我最大的努力不手动编辑openapi.json。我们是否必须在openapi.json版本2.0中手动配置api</em
浏览 6提问于2022-02-09得票数 2
情况如下:我有许多经过单元测试的API。一个swagger规范(swagger2.0)是由API上的代码注释自动生成的。我目前正在考虑根据自动测试脚本中的模式验证JSON响应，但这真的很有用
浏览 0提问于2021-03-05得票数 1
回答已采纳
我正在阅读有关flask-restx的swagger文档的the documentation，并遵循以下示例。我知道为了生成API参数的swagger文档，我应该这样做。@api.doc(params={'id': 'An ID'}) 但是，我找不到如何记录API响应正文
浏览 85提问于2021-09-08得票数 0
回答已采纳
4回答
我必须记录我的API，我必须使用其中的任何一个或。我想知道哪一个有更多的选择，利弊，哪个更好。
浏览 0提问于2015-04-06得票数 35
回答已采纳
1回答
我正在尝试实现一个Swagger文档，比如附带的屏幕截图。我有一个昂首阔步的端点。我希望自定义Swagger以如下方式显示API文档：
API名称 API Description Swagger UI --在这里试用单个API通过其端点URL >H19</code>API字段<
浏览 0提问于2020-05-27得票数 0
API的成功响应是json格式(基于avro模式)。对于错误，它是否应该为异常定义另一种格式(模式)？或者，成功的响应是否应该包含一个错误部分？当发生错误时，将其他部分保留为空，仅填充错误。这更像是一个内部API，需要定义各种自定义异常消息。它是否应该对所有此类应用程序错误使用相同的HTTP状态代码</
浏览 0提问于2020-08-12得票数 0
2回答
我正在寻找一种简单的方法来返回Web API中所有请求到给定路由的404错误，以及该路由中的所有端点。在我的场景中，我将有一个配置标志来打开和关闭它。它是一个使用Swagger/Swashbuckle的文档端点，并希望能够将其作为一种功能切换打开或关闭。<add key="EnableDocumentation" value="true|false&qu
浏览 4提问于2014-07-14得票数 0
我有一个基本的nodejs restify服务器，有两个简单的方法，一个GET和一个POST。我正在尝试将swagger API文档添加到我的restify服务之上。找到了对express的支持。还发现了一些库https://www.npmjs.com/package/swagger-restify。但我不知道如何在code.How中使用它来添加它，这样我<e
浏览 60提问于2021-02-12得票数 2
我有一个在IBM Cloud中运行的测试Hyperledger Fabric，以及IBM Blockchain Application Service。我还有一个运行Hyperledger Composer REST Server的kubernetes集群。一切都很好，但是我如何用一些自定义api来扩展REST api呢？文档提到能够在IBM API Connect或Strongloop product...but中
浏览 1提问于2018-02-10得票数 1
4回答
我在Jersey2.17和杰克逊有一些RESTful API。它们都采用JSON风格，工作非常好。首先我试了，
它使用Json示例直接生成HTML文档。然后我尝试了，它知道一些杰克逊注释，比如@JsonProperty，但仍然不能处理@JsonIgnore。它也是数据模式的描述，而不是示例。如果API直接返回J
浏览 3提问于2016-12-06得票数 0
回答已采纳
我想就我面临的一个问题寻求您的帮助。因此，基本上我为API定义了swagger 2.0规范，并且在操作的响应上，我使用schema属性来引用反映响应结构的对象的一些定义。我在Swagger编辑器上验证了规范，它是有效的，而且如果我使用Swagger<
浏览 19提问于2018-08-23得票数 1
回答已采纳
1回答
目前使用springfox 2.9.2来Swagger记录在Spring中创建的API。我想在文档中添加示例响应，比如在这个图像中；我的理解是，我可以做一些类似的事情： @ApiResponse(code = 200, message不幸的是，上面的两个例子总是显示:标识符期望错误@Api
浏览 0提问于2018-12-04得票数 16
我想使用Swagger2.0来记录REST，因为这似乎被广泛地用于文档RET。
但是，我不确定如何将文档和实现保存在同步中？例如，当我添加新的API时，我必须确保API文档中使用的模型(用于表示响应)应该与REST实现中创建的模型相同。类似地，文档中给出的资源名称应该与实现中的</em
浏览 3提问于2015-06-18得票数 8
云服务器
ICP备案
云直播
实时音视频
即时通信 IM
腾讯云开发者
