我有一个在swagger中记录的API，我想要有某种类型的切换来使描述的某些部分成为内部。- name: abc line1 line3 在上面的示例中，是否可以引入某种切换，这样line3就不会显示在最终文档中我使用openapi-filter.js将对象和属性标记为x-internal，但我不知道如何切换描述<
浏览 11提问于2020-09-04得票数 0
1回答
我有一个返回对象的Web API REST web服务。我已经安装了以及Swagger UI。我希望Swagger UI列出从Web API REST方法返回的对象中的字段。这个是可能的吗？在Swagger文档中，Swagger.NET使用ApiExplorer收集有关我拥有的Web API端点(扩展ApiController的类)的</
浏览 9提问于2013-04-24得票数 2
我有超过5k行长的swagger.json文件，描述了数百条路径和对象。我希望只使用端点的一部分生成一个TypeScript客户机(使用swagger-codegen)。我不希望生成的TypeScript应用程序包含与swagger.json未使用部分连接的类或接口
如何只过滤掉Swagger文档的一部分，描述指定的路径组(例如
浏览 9提问于2016-09-30得票数 1
回答已采纳
我有一个ruby on rails应用程序，它没有API服务器，因为它只向客户端公开API。现在，我有了这些apis的swagger文档。在url上提供swagger ui的可能方式是什么？由于没有web服务器，我想知道是否有其他相同的选择。谢谢
浏览 2提问于2021-07-08得票数 1
如何使用Swagger记录GraphQL？我们有一个庞大的后端REST API，最近部分开始使用GraphQL。为了记录API，我们使用Swagger。问题是:如何使用Swagger(OpenAPI)来记录GraphQL端点？在Swagger或GraphQL的官方文件中绝对没有相关信息。
浏览 4提问于2020-09-11得票数 14
是否可以在openapi3.0/swagger中将内联图像渲染为描述文本等的一部分？在查看规范时，我所能找到的就是能够链接到请求示例中的图像，特别是。我想要的是能够在我的API的介绍性文本中包括图表等，类似于markdown等。示例： openapi: 3.0.2 version: "1.0.0"
浏览 25提问于2019-08-29得票数 3
1回答
我已经在我现有的Rails应用程序中集成了。我在我的应用程序中添加了一个新的模型"Book“，现在我想更新我的api-docs。我怎么能这么做？我正在尝试rake swagger:docs，但这不会改变任何事情。另外，在books_controller direcotry中也没有其他控制器已经存在的app/controller/api/v1/。我是Rails和
浏览 12提问于2014-12-04得票数 1
回答已采纳
Spring REST Docs最近发布了，文档中说：
这种方法可以使您摆脱像Swagger这样的工具所施加的限制。因此，我想问一下，与Swagger相比，Spring REST文档什么时候更适合使用，以及它能释放哪些限制。
浏览 3提问于2015-12-24得票数 42
回答已采纳
2回答
在其站点的developer部分，MailChimp链接到描述其API的JSON模式。
我熟悉JSON模式(v4草案)。我理解它们在API有效负载验证、文档生成等方面的作用，我也熟悉它们与Swagger (OpenAPI)模式的对比(它们在某些方面相似，但更全面地记录了API)。看来，MailChimp的模式是一种类似Swagger的A
浏览 3提问于2016-12-09得票数 2
回答已采纳
我正在用Swagger创建一个API文档。我直接尝试了openapi 3.0。不知何故，我无法得到我的请求机构的工作描述。type: string - name - password
我想得到像Swagger 2那样的东西。下面是相同的代码如何转换为<
浏览 0提问于2018-06-26得票数 2
回答已采纳
1回答
最近，我开始为我们的RESTful apis生成文档。我使用yamlbeans-1.09.jar将我的Java转换为yaml文件。所有操作都很好，yaml甚至在上得到了正确的验证，但是在使用Swagger接口测试它时，它仍然给出了一个错误“预期类型字符串，但是在我提到文件中的swagger : 2.0时发现了类型整数”和"No for我的样本yml文件是：
basePath: /
浏览 5提问于2015-04-29得票数 0
回答已采纳
使用Restler 3.0.0-RC6 (内部包swagger)，我有一个API方法定义如下： public function fetchArray($sql, $args = null) {
然后，我通过Restler's addAPIClass包含的所有类都扩展了这个这意味着当swagger运行时，每个API都显示一个fetchArray函数。我希望该方法不会出现在swagger文档
浏览 5提问于2014-09-21得票数 1
回答已采纳
我正在构建一个Spring Boot应用程序，并使用Springfox Swagger UI使用Swagger UI对其进行记录。我已经有了所有的文档，但想自定义标题和描述，但不知道如何。例如，在下面的图像中：标题是"Springfox petstore API“，描述是Lorem Ipsum。但是在我的Swagger UI中，标题和描述都是"API文档“。
浏览 2提问于2017-11-10得票数 9
回答已采纳
2回答
我正在使用.Net core 3.1，并致力于在Swagger中记录应用程序接口操作，并希望记录请求正文，以便它将显示所有细节，如数据类型，验证等最终用户。目前，我正在对xml注释中的模式进行硬编码，如下所示： /// Order Details /// <remarksActionResult
浏览 25提问于2021-02-19得票数 1
4回答
我必须记录我的API，我必须使用其中的任何一个或。我想知道哪一个有更多的选择，利弊，哪个更好。
浏览 0提问于2015-04-06得票数 35
回答已采纳
目前，我使用了API的语义版本控制。版本控制是这样的：如果我只更新文档(swagger，内部文档化，YAML，.)要添加示例，还是要更正附加到API的描述？
(谢谢你的帮助;)
浏览 1提问于2019-12-03得票数 2
回答已采纳
我们有一个使用http和JSON作为RPC方法的系统。它是内部组件通信的内部解决方案。我并不害怕混淆现有的代码，但我想知道是否有人有类似的经验。目标是使用Swagger显示漂亮的文档，并为用户提供一个调用Apis<em
浏览 4提问于2015-01-14得票数 0
回答已采纳
下面是pom.xml的相关部分 <groupId>com.google.code.maven-replacer-plugin</groupId></executions> <file>target/swagger<value>${project.version}</valu
浏览 23提问于2015-06-03得票数 2
我是api文档时代的新手。但是，现实世界的API文档会发生什么呢？我是否有使用不同数据存储的demo.api.myawesome.com文档和api.myawesome. com上的实际应用编程接口？但再次深入挖掘，我发现应用程序接口可以使
浏览 2提问于2017-07-14得票数 1
云服务器
ICP备案
实时音视频
对象存储
即时通信 IM
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号