有没有办法命名一个自定义属性'type'，假设已经存在一个特殊的'type‘属性，这是一个保留的关键字。type: string - radiogroup
- checkbox 不能修改生成JSON消息的后端系统来重命名该属性。谢谢。
浏览 11提问于2019-02-27得票数 5
回答已采纳
2回答
我正在尝试合并micronaut swagger UI中的附加文件模式。我认为该文件在构建过程中不会被捕获，因此不确定如何为该附加文件设置正确的路径。
micronaut: additional:
files= src/main/resources/swaggeryml文件中，这些配置不存在，我认为在构建
浏览 0提问于2021-01-15得票数 2
2回答
我在这里研究如何在一个文件中合并几个OpenApi v3组件定义，试图找到一个解决方案。
现在，您需要将所有组件s.v1.yaml组合到一个模式中(我将其命名为blueprint.v1.yaml)。通常，我使用swagger-cli合并所有$ref依赖项，但现在情况并非如此，因为我不能引用整个
浏览 4提问于2020-04-17得票数 10
回答已采纳
1回答
我在rest服务中使用了一个dto作为请求主体： @Data @JsonAlias("myAlias")} 当我们生成openapi/swagger yaml时，属性名是"myProperty“ 是否可以自动强制生成openapi/swagger中的别名？在yaml创建
浏览 18提问于2021-04-27得票数 0
回答已采纳
我可以从OpenAPI中自定义。我用一个@RestController创建了一个简单的springboot项目。我创建openapi.yaml并将其复制到/src/main/resources/。
但我在打开的swagger页面上看到了默认值。
浏览 17提问于2020-05-29得票数 4
回答已采纳
例如，我有文件widgets.a.yaml # schema def # schema defWidgetB1如果我试图引用这两个文件，如：# ther OpenAPI def stuffcomponents: { $ref: widgets.a.yamlSwagger工具链抛出一个错误，说明schemas中有一
浏览 4提问于2020-11-21得票数 1
我可以通过两个单独的openapi.yaml文件和两个maven执行来实现这一点。我正在使用swagger-codegen-maven-plugin来完成它，我只能找到使用不同插件的swagger.yaml或openapi.yaml的代码。我找不到这个密码，虽然我肯定这是可能的。问题是，如果我有两个作用域，如'DB‘和'Browse'，并且我希望为两个作用域(如DBAp
浏览 6提问于2022-03-02得票数 0
问题是，当我们的Swagger渲染渲染我们的.yaml文件时，它显示的示例cURL命令无法从命令提示符运行。如何在Swagger规范中添加默认值，以便OpenAPI渲染器在生成示例curl命令时包含标题？下面是.yaml文件中我们的方法的一个示例： '/{jobId}/start': - in: header
name: Content-Lengthdefault<
浏览 113提问于2020-09-17得票数 0
我已经将我的Jersey REST Service文档升级到swagger openapi v3。现在，我想介绍一个根据用户授权过滤方法的方法，以便只在swagger-ui/ openapi.yaml文档中显示特定的API方法。我最接近的方法是使用一个扩展io.swagger.v3.core.filter.AbstractSpecFilter的过滤器类ApiAuthorizationFilterImpl。中，如</e
浏览 25提问于2020-12-14得票数 1
1回答
我想使成为JSON文件中的一个表，
Swagger说，GFM语法可以用于富文本表示。在openapi.json中包含表有什么解决办法吗？
浏览 0提问于2018-01-31得票数 6
我正在使用创建一个非常简单的节点API的文档。这更像是一个"UI/UX“问题，但却困扰着我。
浏览 4提问于2022-07-22得票数 1
回答已采纳
2回答
如果我在editor.swagger.io中粘贴以下规范：info: version: 1.0.0描述在一行上呈现：即使yaml规范声明块样式字符串保留换行符：
如何在swagger编辑器中使用</em
浏览 3提问于2020-09-27得票数 3
我已经在外部安装了swagger，我只是想将swagger-ui (开放源码)实例连接到openapi.yaml的localhost:8000/doc/api (openapi.yaml)。PS :我试着用public OpenAPI customOpenAPI() { .components(newspringdoc.org")))
浏览 3提问于2020-10-14得票数 0
回答已采纳
我正在生成Rest端点，包括将Openapi/Swagger注释添加到生成的代码中。
虽然它在基本类型中运行得很好，但是我在定制类方面有一些问题。现在，对于自定义类，我有很多重复的模式条目(使用@ schema (implementation = MyClass.class))，但至少有需要的信息。但是，我想找到一种方法来，删除重复的模式条目，同时保留附加信息。在讨论$ref和缺乏同级属性的github问题上，我发现是如何在yaml<
浏览 0提问于2019-08-12得票数 6
我有一个已经从swagger 2.0更新到openapi 3.0.0的yaml规范。我不想将这段代码复制/粘贴到某个在线位置，因为我不想公开所有的路由。
浏览 0提问于2020-02-14得票数 5
回答已采纳
讨论如何使用jsonschema将属性指定为null或引用。
注意:一些swagger实现使用x-nullabl
浏览 14提问于2016-12-01得票数 35
回答已采纳
我正在使用进行OpenAPI表示，但我认为我的问题与这个包无关，对我来说，这似乎是一个更通用的OpenAPI (但不是100%确定我是否正确)。'schema-swagger-ui'),
path('swagger.yaml/', SpectacularAPIView.as_view(), name='schema-swagger-yaml我想要实现的是，将Swagger</e
浏览 7提问于2020-07-10得票数 11
回答已采纳
12回答
有没有一种为swagger 2.0创建静态文档的方法？也许就像editor.swagger.io上的“预览”一样。
我需要获取静态html文件，这样我才能将它们包含在一些静态文档中。我看到有一些swagger -codegen静态文档，但这只适用于swagger <= 1.2。
浏览 7提问于2014-10-28得票数 78
假设我有Openapi规范文件(api-docs.yml)。我使用的是基于Java的解决方案(maven插件等)都是首选。
浏览 2提问于2021-11-09得票数 2
回答已采纳
我是OpenAPI/Swagger的新手。我知道我可以发送额外的数据。但是，如何将其描述为OpenAPI上的文档，以便一个人(或程序)知道他们可以随user_id一起发送任何字段(例如，姓名、位置
浏览 39提问于2019-08-23得票数 3
回答已采纳
云服务器
ICP备案
腾讯会议
云直播
对象存储
腾讯云开发者
