openapi

1熱度

1回答

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

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

0熱度

1回答

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

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

1熱度

1回答

Swagger：如何獲得格式化示例json

我真的很難理解響應的examples部分的格式。我爲500內部服務器錯誤定義了以下響應。 500InternalServerError: description: The server encountered an unexpected condition which prevented it from fulfilling the request schema:

0熱度

1回答

Springfox（swagger） - 如何添加動態attributs

我想在我的java彈簧項目中的swagger定義中添加新的attribut。我已閱讀文檔和專門 https://springfox.github.io/springfox/docs/snapshot/#plugins 但我沒能從頭我試圖將此代碼添加新的屬性，但它不是真的是我想要的： import java.util.HashMap; import java.util.Map; impor

0熱度

1回答

_link模型 - HATEOAS

我已經要求執行HATEOAS作爲我們的休息API的一部分，這是響應如何在揚鞭規範定義 _links: [ { rel: string The relationship to the request e.g. self which contains the resource that was requested or {object name}, a link to a resource

2熱度

2回答

OpenAPI中的'required'是什麼意思

鑑於以下OpenAPI定義，下列哪些對象是有效的。只是1.或1.和2.？ Person: required: - id type: object properties: id: type: string {"id": ""} {"id": null} {} 這歸結爲是否「需要=真」的問題是指「非空值」或「屬性必須在場「。 J

0熱度

1回答

開放API規範連接拒絕

我遇到了我的OPENAPI規範文件的問題。我試圖調用一個暴露的URL來'GET'一個ID，但每次我端口轉發服務到我的本地，然後嘗試通過API文檔發送請求我的連接被拒絕。我將不勝感激任何幫助。我期待的ID將是JSON格式。下面是我的規格文件 - openapi: "3.0.0" info: version: 1.0.0 title: Id Generator servers:

4熱度

1回答

AWS API網關是否支持OpenAPI 3.0？

我在文檔中的某處閱讀了AWS API Gateway對Swagger的支持，但Swagger現在更加正式地稱爲OpenAPI規範，並且已經碰到主要版本3.0。

0熱度

1回答

Web API對象共享

我的對象有問題。我曾經有大多是相同的，但一個有一些額外的領域兩個對象，所以它們合併成一個。現在我遇到的問題是，當我使用招搖做我的web API文檔則顯示整個對象，但對於一些電話，我只希望使用對象的一部分。我的問題是，如果我有一個基本值一個對象，是有可能使另一個對象使用的基本對象爲起點/參考從中我可以加我需要的額外的價值？

1熱度

1回答

谷歌雲端點 - 方法不存在 - OpenAPI的YAML規範

我試圖安裝使用谷歌雲端點和谷歌應用程序引擎的NodeJS REST API。我從GitHub克隆中的官樣的項目並使用Quickstart組建谷歌雲端點。開箱即用，它工作正常，但我嘗試添加另一API端點在/ GET請求，但在我，我得到的響應部署和提出請求如下： { "code": 5, "message": "Method does not exist.", "details": [