swagger-2.0

0熱度

1回答

所以我有一個使用引用參數的路徑，但引用的參數不是required: true，我想補充。我以爲我可以使用下面的語法爲： operationId: getReports summary: Get the reports parameters: - $ref: '#/parameters/reportStartDate' required:true - $ref: '#/parameters/repo

1熱度

1回答

如何在swagger規範中表示十進制浮點數？

我想在我的api文檔中使用2位數和小數位來表示小數。我正在使用swagger 2.0，規範中是否有內置的定義類型或其他'round'參數，或者我唯一的選擇是使用'x-'擴展名？

1熱度

1回答

Swagger UI上的服務器響應爲空

我有一個與Swagger UI集成的REST API。但是，當我嘗試從Swagger UI執行請求時，該界面僅向我顯示curl命令，但不提供服務器響應。 curl命令在從命令行運行時返回預期的響應，但在UI本身中沒有任何顯示。我能做些什麼來解決這個問題？

4熱度

1回答

在Visual Studio 2017中自動生成OpenAPI json文件

我正在開發VS2017 5.13（預覽版）中的Azure函數，我想從我從Azure門戶生成的OpenAPI（aka swagger）生成項目文檔。 visual studio不生成該文件，所以我從Azure門戶獲得了最初的文件，但我想自動更新代碼。是否有官方演示如何集成swagger json文件以從VS 2017中的代碼生成文檔？

2熱度

3回答

在Swagger 2.0的定義中使用「security」關鍵字的屬性名稱

我的定義部分中有一個對象，需要一個名爲security的屬性，但是當我這樣做時，那個Swagger編輯器會給我錯誤消息：在definitions.User.properties.security.properties語義錯誤安全要求必須在安全定義跳轉匹配線49 這裏是我的定義 definitions: Security: type: object propert

1熱度

1回答

返回對象的數組，妥善定義SDK響應

我有一個典型的REST風格的端點返回模型的集合，但產生的Ruby SDK返回一個新的模式，而不是Matters的車型陣列。我可以破解生成的源代碼返回Array<Matter>，但這是一個維護頭痛。我如何指定我想在YAML中返回Array<Matter>？ paths: /matters: get: ... responses: 200:

0熱度

1回答

我的Swagger文檔（又名Open API）應該定義500個響應代碼嗎？

如果我打算使用像AutoRest這樣的客戶端生成器，我希望生成的客戶端能夠預測500個錯誤嗎？或者，我是否希望在try/catch中包裝客戶端請求？這只是我需要做的一個風格決定嗎？

1熱度

1回答

當試圖創建休息api時獲取重複操作ID

我試了幾個小時纔得到這個固定的，我不斷收到錯誤： [致命]錯誤生成客戶端模型：找到操作對象與重複operationId'recent_items'。 OperationId在API中描述的所有操作中必須是唯一的。我使用的Visual Studio 2017年 Azure的SQL數據庫 C＃我看不到任何重複operationid在下面的（我也似乎無法整齊地格式化，在這裏 - ！很抱歉） {

0熱度

1回答

如何使用Swagger UI自動授權所有端點？

我已經使用Swagger UI部署和訪問了整個API。它使用基於HTTPS的基本身份驗證，並且可以輕鬆地點擊授權按鈕並輸入憑證，並且可以很好地工作。試用一下！特徵。但是，我想用共享的用戶名和密碼製作一個公共沙盒版本的API，它總是通過驗證;也就是說，沒有人應該提出授權對話框來輸入憑證。我試圖把下面的代碼script元素內的HTML網頁上輸入基於從另一個StackOverflow的問題的答案授權

0熱度

1回答

如何在django rest framework swagger中顯示多個值參數？

Versions: coreapi==2.3.1 Django==1.11.2 django-rest-framework==0.1.0 django-rest-swagger==2.1.2 django-silk==1.0.0 djangorestframework==3.6.3 API端點：/search?filter=("pages")?filter=("people") 在