openapi

0熱度

2回答

當我請求url時，部署的Google Endpoints Quickstart應用程序給出錯誤消息？

我正在遵循標準環境中App Engine上Cloud端點框架的快速入門。我已經部署了示例API。當我打開https://[my-project].appspot.com/我得到的錯誤信息： Error: Not Found. The Requested URL/was not found on this server 該日誌顯示的消息： No Handlers matched this url

0熱度

1回答

如何使用OpenAPI規範

讀取此post（請參閱：3如何在使用OpenAPI（Swagger）規範描述REST API時使用單一定義...），您可以注意如何使用OpenAPI使用readOnly屬性保留一個資源表示，用於添加/更新並獲取資源，而不是使用一個表示獲取（GET集合項），另一個用於添加（POST集合）。例如，在以下用戶單一表示中，ID是是隻讀屬性，這意味着在創建用戶時不會在表示中發送它，它將在用戶檢索時出現在表示

4熱度

1回答

允許招搖查詢參數是字符串或者整數

在使用swagger2（OpenAPI的）構建一個REST API的陣列，我想允許查詢參數station_id支持下列： station_id = 23（返回站23）？station_id = 23,45（返回站23和45）？station_id = [3:14]（返回站3至14）？station_id = 100％（％S充當通配符如此返回像1001, 10049等的東西。）我使用下面招搖

4熱度

1回答

撰寫使用多種內容類型的swagger文檔，例如應用程序/ JSON和應用程序/ x-www-form-urlencoded（無重複）

我正在尋找一種優雅的方式來定義一個可以使用JSON數據以及表單數據的api。下面的代碼片段很有用，但它不夠高雅，並且需要後端中的所有醜陋代碼。有沒有更好的方法來定義這個？什麼現在的工作： paths: /pets: post: consumes: - application/x-www-form-urlencoded - applicati

0熱度

1回答

PayPal支付API的Swagger格式

我是OpenAPI的新手，我需要一些幫助來創建PayPal的payment API的基本招搖檔案，以從我們的平臺創建支付。注意：OAuth已配置。下面是一個基本的招搖文件，但我不知道在哪裏添加paymet request information（即意圖，付款人，交易等）爲： { "swagger": "2.0", "info": { "description":

2熱度

1回答

將Swagger OpenAPI規範添加到彈簧引導項目

我發現此項目據我瞭解，我們可以在.json/.yml文件中編寫文檔。正如我可以在http://editor.swagger.io/它可以很容易地呈現爲.html文件。所以我的問題 - 我如何能從這些文件生成靜態.html頁面？有沒有彈簧啓動應用程序的任何教程？我應該以某種方式給.json/.yml文件來搭配配置來準備.html文件與文檔？

7熱度

4回答

com.google.api.config.ServiceConfigSupplier - 無法獲取服務的默認配置版本（僅在本地主機上）

我正在使用Cloud Endpoints Frameworks（2.0.1）for Java作爲我最後一年的項目的一部分，並已迄今爲止相對成功。我在部署到我的appspot.com域時沒有任何問題，但是，在本地部署時遇到了一些問題。（下面的代碼塊到我的項目-ID的任何引用是我的實際谷歌雲項目編號別名）我有一個註釋@API類的有效OpenAPI的描述符（openapi.json）的我正在使用「

2熱度

1回答

如何在OpenAPI（Swagger）中指定多個404原因？

我正在爲嵌套資源（屬於傳遞的內容）定義路徑。如果客戶端得到404，那麼可能是因爲未找到傳遞ID，或者傳遞未包含任何指定類型的內容。如何建模使用OpenAPI（YAML）？我有現在這個權利... paths: '/deliveries/{id}/content/articles': get: summary: Retrieves articles from a d

1熱度

2回答

OpenAPI/JSON Schema中的多繼承/組合

在OpenAPI中，使用allof可以實現繼承。例如，在this example： "definitions": { "Pet": { "type": "object", "allOf": [ { "$ref": "#/definitions/NewPet" # <--- here }, [...] ]

10熱度

1回答

具有不同所需屬性的重複使用模型

我有一個路徑，它爲每個http方法使用幾乎具有相同屬性的複雜模型。問題是我想爲PUT和POST的請求定義一些所需的屬性，而GET響應中不需要屬性（因爲服務器始終返回所有屬性，並且在文檔的其他地方提到了它）。我創建了一個簡單的貓API來演示我所嘗試過的。這個想法是，對於GET響應，響應模型沒有任何標記，但是PUT的請求必須有一個貓的名字。 swagger: "2.0" info: t