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 實現 ...