我为RESTful服务创建了一个OpenAPI JSON文档，并使用ReDoc来显示它。 有没有一种方法可以将OpenAPI规范作为JSON对象直接传递给ReDoc，而不使用JSON文件或URL？DOCTYPE html> <head>
<title>ReDoc</
浏览 28提问于2021-06-28得票数 0
我的用例如下:我在Spring Boot应用程序中使用SpringFox Swagger2生成json格式的OpenAPI编译器规范。在检查生成的/v2/api-docs以及swagger-ui.html之后，我可以确认此模型与所有其他模型一起被正确地放置在“定义”属性下。另一方面，ReDoc似乎只呈现端点及其显式使用的模型和响应。我能以某种方式强制ReDoc呈现一个额外的类吗？例如，在API描述中以某种方式引用它？
我不确定，但我认为这与有关。如果
浏览 5提问于2018-07-10得票数 1
回答已采纳
OpenAPI v3使用JSON或YAML格式提供。但是，有时我需要嵌入一个消息示例，它的类型是对象。我通常有JSON格式的示例，。，而OpenAPI需要一个对象。我们有什么选项可以在YAML规范中嵌入一个JSON作为示例值吗？目前，我将JSON</
浏览 15提问于2022-07-13得票数 1
回答已采纳
3回答
我想在我的ReDoc中添加一些额外的选项。对于当前的实现，我使用从Swagger生成的json文件，并将其添加到html页面中。例如，如何做到这一点： <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
<scriptsrc="https://c
浏览 0提问于2018-10-11得票数 3
回答已采纳
4回答
include samples/settings.json最后两行在这里很重要--使用!include <filepath>的行--在RAML中，我可以将整个契约分割成许多文件，这些文件都是由RAML解析器动态包含的(基于RAML的所有工具都使用RAML解析器)。但是这是非常重要的：我可以在其他工具中重用模式文件来执行验证、模拟生成、存根、生成测试等等。这是整个规范<
浏览 16提问于2016-02-22得票数 5
1回答
我有一个Java3.0规范( YAML格式)，希望为OpenAPI生成代码。我希望将其作为自动构建(最好使用Gradle)的一部分来完成，这样我就可以创建服务接口，并将接口的实现作为自动化过程的一部分。: 3.0.0 ]处读取com.fasterxml.jackson.core.JsonParseException:未识别的令牌'openapi'：期望(JSON字符串、数字、数组、对象或令牌'null3.0吗</e
浏览 6提问于2020-01-23得票数 10
回答已采纳
12回答
有没有一种为swagger 2.0创建静态文档的方法？也许就像editor.swagger.io上的“预览”一样。到目前为止，我还没有找到这样做的方法。我看到有一些swagger -codegen静态文档，但这只适用于swagger <= 1.2。
浏览 7提问于2014-10-28得票数 78
2回答
在有关参数序列化的OpenAPI文档中，有一个关于如何序列化具有不同样式的查询、路径、头和cookie参数的简短章节。这些参数的模式被描述为OpenAPI风格的json模式，它允许无限嵌套对象和数组。中)：我的问题：
如果不是的话，这在官方文件中有提到过吗</
浏览 10提问于2021-05-28得票数 2
回答已采纳
我正在使用进行OpenAPI表示，但我认为我的问题与这个包无关，对我来说，这似乎是一个更通用的OpenAPI (但不是100%确定我是否正确)。/', SpectacularJSONAPIView.as_view(), name='schema-swagger-json'),
path('redoc/', SpectacularRedocView.as_view(url_name='schema-swagger-yaml'),
浏览 7提问于2020-07-10得票数 11
回答已采纳
我希望从OpenApiSchema 6中的任何给定Json对象动态生成.Net。我在代码中没有clr类型可以自动生成Swashbuckle使用的Open，并且需要通过编程方式这样做，并且不需要使用单个对象生成器工具。此外，这些Json对象将由其他用户频繁地更改。我的目标是从给定的json有效负载动态创建OpenAPI规范。给出如下所示的随机Json，并使用C#生成类似于此方法的OpenApiSchema，。我需要做的
浏览 3提问于2022-10-08得票数 1
maxlength:15in: "query"x-phase-dataelem: "CONF//Y/N"
我知道，这些值正在传递给客户端有人能帮忙吗？
浏览 1提问于2021-12-01得票数 0
回答已采纳
我将fastAPI与nginx一起用作反向代理。我将API分成两个不同的main.py，具有不同的端点：
main_slow.py ->主要位置/APIs末端：/slow_api使用nginx作为反向代理，我可以在单个端口(8000)下使用自己的端点调用API，然后nginx将负责将它们传递到正确的fastAPI端口。auth_basic_user_file /etc&#
浏览 0提问于2021-05-05得票数 2
回答已采纳
我在一个更大的python项目中使用生成的openapi python flask服务器(由openapi-generator-cli-4.2.3.jar生成)。其中一个openapi控制器需要访问我的数据库。另一个控制器需要一个对象列表。这两个信息都已经被python项目使用了。我的想法是将所有需要的信息作为变量传递给main方法(在__main__.py中)。但是如何将变量传递给控制器或其中的函数呢？还有其他(更好的)方法
浏览 9提问于2020-02-24得票数 0
考虑一个由多个端点组成的应用程序，其中一些是同步的，另一些是异步的，遵循事件驱动的体系结构，使用Kafka作为消息代理，与其他微服务通信。这些API的文档标准应该是什么？我们是否需要为异步API(使用AsyncAPI)和同步API(使用OpenAPI)创建单独的文档页，或者有没有办法将这两种API合并到一个文档中？我在网上读到，AsyncAPI是异步API的文档标准，OpenAPI应该用于普通的同步Rest API，但如果我们在单个应用程序中混合使用不同种类的API，则找不到任何相关链接。
浏览 10提问于2021-04-12得票数 4
我搜索了一下，发现在以前的版本中，这可以通过嵌入我的自定义样式表，然后将其插入到中间件配置中，这样做的方法如下：{我的中间件管道中有.UseStaticFiles()。
我遗漏了什么？
浏览 1提问于2019-05-05得票数 3
回答已采纳
我目前正在寻找从大型OpenAPI规范中提取所有JSON模式。我一直在使用以下NuGet包：我希望使用这些来解析大型Open规范并提取所有JSON模式，我能够将这些模式解析为“Microsoft.OpenApi.Models.OpenApiSchema”对象。但我似乎无法从这些对象创
浏览 20提问于2022-04-21得票数 3
回答已采纳
1回答
Swagger/OpenAPI2.0中的Schema对象是否必须具有type属性？
一方面，根据JSON草案4规范，不指定type属性是OK的，这意味着实例可以是任何类型(对象、数组或原语)。另一方面，我看到了很多Swagger模式，它们包含没有type属性的Schema对象，但是包含了properties属性，这表明模式作者希望实例是一个适当的对象(并且不想接受数组或原语作为有效值)。所有这些架构都不正确吗</em
浏览 2提问于2017-11-19得票数 7
回答已采纳
我正在处理大量的OpenAPI 3.0.0文件，我需要从这些文件创建html页面。每个OpenAPI文件表示大型对象模型中的一个实体。Swagger、redoc和其他工具不产生我需要的文档类型。由于有这么多，我想将一个环境变量传递给jq。= null)' file.json
在脚本文件中，这种方法是类似的，而且我得到了预期的结果。但是，考虑到我所要做的事情的性质，我想使用jq -f选项将jq命令放入文件中。我能够用下面的示例脚本验证变量可以传
浏览 28提问于2022-03-30得票数 2
回答已采纳
有插件，上面写着支持Swagger2.0，但实际上它使用的是，而不是2.0，因此不支持OpenApi3.0。"io.swagger.core.v3" % "swagger-core" % "2.0.5"[error]
浏览 0提问于2018-09-24得票数 3
我现在想知道是否有任何工具可以自动检查生成的OpenAPI文档(= Swagger )与RESTful API设计最佳实践的一致性。例如，Zalando为REST设计定义了一个可公开使用的指南，在这些指南中，有许多规则可以根据OpenAPI规范自动检查：
与字典相比，“保持URL无动
浏览 0提问于2017-09-29得票数 4
云服务器
ICP备案
腾讯会议
云直播
对象存储
腾讯云开发者
