标签[openapi] - 堆栈内存溢出

NSwag 中接口上鉴别器的 KnownType 等价物 - KnownType equivalent for discriminator on Interfaces in NSwag

赏金将在 9 小时后到期。此问题的答案有资格获得+100声望赏金。 DavGarcia正在从信誉良好的来源寻找答案。当我们需要告诉 NSwag 和生成的 OpenAPI 3.0 文档，抽象的 class 应该在客户端转换为某种具体类型时，我使用[KnownType]和鉴别器并且效果很好：我 ...

Swagger UI OpenAPI 3，查询参数显示为 object 而不是值可变字段 - Swagger UI OpenAPI 3, query parameters displayed as an object instead of value-changeable fields

以前在 SpringBoot v2.5.7 中，我有这个 Spring REST controller 方法。它有一个TestCriteria类型的 DTO，作为路径参数。@GetMapping(path = "/test") public void test(TestCriteria testC ...

openapi-generator 和“忽略请求正文中的复杂示例”消息 - openapi-generator and "ignoring complex example on request body" message

我使用 org.openapi.generator gradle 插件（版本 6.2.1），当我从我的 openapi.yml 文件生成 spring 代码时，我收到以下消息“忽略请求正文中的复杂示例”。我不明白为什么，有人有想法吗？这是我的 openapi.yml 文件的摘录：感谢您的帮助我 ...

有没有办法为 javax.ws.rs 中的所有端点定义查询参数？ - Is there a way to define queryparams for all endpoints in javax.ws.rs?

我正在尝试使用 javax.ws.rs 注释来记录一个已经存在的应用程序，以定义特定端点需要的标头 (@HeaderParam) 和参数 (@QueryParam)。此信息将用于为应用程序生成 swagger 页面。我已经确定了一组所有端点都需要的“@HeaderParam”。我需要知道是否 ...

OpenAPI：指定一个可选请求 object 但带有必填字段 - OpenAPI: Specifying an optional request object but with mandatory fields

我在 Maven + Spring Boot (2.7.7) 上使用 OpenApi 生成器设置来生成 API 接口以在我的软件中实现。这包括验证。我试图了解是否有一种方法可以在 OpenApi（3.0.1 atm 但我很灵活）yaml 中指定验证，这样我就可以让 object 不是强制性的，但 ...

从应用程序属性加载文件时无法加载 api 定义 - Failed to load api definition when loading files from application properties

我有一个通过 restdocs 生成并转换成这种格式的 openapi 文件。它们被添加到资源文件夹中，属性文件指向它们的格式，但是，swagger 加载失败，我不确定我还缺少什么。非常感谢。 ...

如何用我已有的 openapi 更改 swagger.json 文件 - How can change swagger.json file with my openapi which I already have

我有一个示例 restapi 项目，我还有另一个针对我的 API 的开放式 API 文档。 I want to replace generated swagger.json with my open API, but I couldn't find swagger.json in my proje ...

在 OpenAPI 3.0 中，如何创建从实体列表到单个实体的链接？ - In OpenAPI 3.0, how do I create a link from a list of entities to a single entity?

在大多数 OpenAPI 3.0 文档（如官方文档）中，引入了链接和 POST 端点的组合，以创建一个返回 ID 的实体，该 ID 链接到 GET 端点以通过相同的返回 ID 获取该实体： POST /users -> UserID GET /users/{UserID} -> Use ...

使用 Open API Definition 通过 Ubuntu 命令行从 OWASP ZAP 运行主动扫描 - Run a active scan from OWASP ZAP through Ubuntu command line using Open API Definition

我正在尝试通过导入外部开放 API 定义，仅使用我的 Ubuntu(22.04) 终端从 OWASP ZAP 运行主动扫描。这可以通过 GUI 轻松完成，但我需要仅使用命令行来完成相同的过程。我也没有找到合适的文档来遵循。我已尝试按照命令结构进行主动扫描，但似乎失败了。谁能建议一种通过 Ub ...

如何在打开api代码生成器输入yml文件中更改包装结构 - How to change packaging structure in open api code generator input yml file

我正在使用打开 api 生成器工具生成 spring 代码，使用 petstore.yaml 来自 swagger 作为输入文件，我想在生成代码时更改默认打包结构。如果是，我可以更改包装结构吗，哪个小胡子文件需要修改我想要这样的包装 ...

在 OpenAPI 3.1.0 中枚举恰好 2 个（略有不同）对象的数组？ - Enumerating an array of exactly 2 (slightly different) objects in OpenAPI 3.1.0?

我需要记录一个 REST 端点，它采用以下请求正文： variables数组必须恰好包含 2 个对象：一个具有所需name groupGuid和typeConstraint string ，另一个具有所需的name addMembership和typeConstraint boolean 。 ...

是否可以更改或配置 OpenLiberty 生成 OpenAPI 文档的“/openapi”url - Is it possible to change or configure the "/openapi" url on which OpenLiberty generates the OpenAPI documentation

是否可以更改 openliberty 生成的 openapi 文档的 url/context-root（microprofile-5.0 和 mpConfig-3.0）默认情况下，这是在“/openapi”上生成的，但我想知道是否可以配置它。我试图查看是否可以使用 mpConfig 配置它，使用 ...

python openai ChatGPT CLI：响应从 API 截断 - python openai ChatGPT CLI: response is truncated from API

这个问题是从 Super User 迁移而来的，因为它可以在 Stack Overflow 上得到解答。 2 天前迁移。 pip install openai后，我试过：我得到文本未完成/截断。我做错了什么？ CF https://github.com/openai/openai-py ...

TypeError: Object 类型 'type' 不是 JSON 可序列化 - TypeError: Object of type 'type' is not JSON serializable

该代码在 Postman 中运行良好，并提供有效响应，但无法生成 OpenAPI/Swagger UI 自动文档。class Role(str, Enum): Internal = "internal" External = "external" class Info(Bas ...

为什么我的 Angular 应用程序的 POST 调用不起作用，但 Postman 没有问题？ - Why does the POST call from my Angular Application does not work, but with Postman there is no Problem?

这个赏金已经结束了。此问题的答案有资格获得+50声望赏金。赏金宽限期在4 小时后结束。 mistermm想提请更多人注意这个问题。问题：我使用 POST 方法调用 localhost:8081/images。它应该将图像上传到 S3 并将信息保存在我的数据库中。结果我得到了一些元信息 ...

使 Swagger-UI 显示操作参数类型的表单 - Make Swagger-UI show a form for operation parameter types

我已经设置了一个 web API 和 ASP.NET Core 和 Swashbuckle。我所有的控制器和动作都正确显示，我可以尝试一下。对于像字符串这样的简单操作参数，会显示一个表单，我可以在发送请求之前在该表单中输入每个参数值。但是，如果该操作需要一个 class 实例（数据结构）作为参 ...

如何将 JAX-RS 资源方法标记为已弃用 OpenAPI？ - How to mark JAX-RS resource method as Deprecated for OpenAPI?

我在 Quarkus 上将 MicroProfile OpenAPI 与 JAX-RS 结合使用，并希望将该资源标记为已弃用，即。在生成的JSON中实现如下结果：将方法标记为 @Deprecated 没有帮助。还有其他方法吗？ ...

Redoc-cli鉴别器 - Redoc-cli discriminator

我通过npm安装了redoc-cli$ redoc-cli --version 0.13.20 现在我用它来构建具有以下内容的文档openapi: 3.1.0 info: title: Sample API version: '1.0' contact: email: some ...

如何在 do.net 应用程序中禁用特定端点的 Swagger 授权 - How to disable Swagger authorization for specific endpoints in dotnet app

我有一个使用 do.net core 7 的 web api。我正在使用 JWT 身份验证。我有一个 controller 归因于Authorize 。该控制器的端点将客户端重定向到外部资源（来自另一个 API），值得注意的是我将端点归因于AllowAnonymous 。我还使用 API 规范 ...

如何删除从 OpenAPI Swagger 3.0 规范带来的默认端点 - How to remove default endpoints brought from OpenAPI Swagger 3.0 specification

我有一个 SpringBoot 应用程序，我为其创建了一个 Swagger 实现。但是，新的 OpenAPI 3.0 规范带来了一个默认部分，其中包含大量不必要的端点/元数据。我找不到解决方案来删除包含所有这些端点的默认部分，这些端点默认添加到我的 REST API 框架的 Swagger 实现 ...