apiary.io

0熱度

1回答

所以我們可以說我有一個200響應哪個機構應該是： { "data": [ { "id": 1, "title": "Activity 1" }, { "id": 1, "title": "Activity 2" } ] } 我設法通過API使用它來獲取響應主體的這種行爲藍圖。 + Re

2熱度

2回答

任何尺寸的Dredd/apiary/MSON數組

我們正在努力在我們的API中描述任意大小的數組。使用API Blueprint和MSON格式進行Dredd測試。端點/點應返回一個「點」（這些是對象）的數組。我們不知道有多少。目前我們只能使dredd驗證陣列的第一個位置。這裏是我們的藍圖： FORMAT: 1A HOST: http://host.com/ # Our API ## Spots [/spots{?type}]

0熱度

1回答

API藍圖（例如：蜂房） - 工具從藍圖

生成JSON的身體是否有一個工具從API藍圖語法使得例如JSON機構幫助？例如，如果我已經制定了這樣的屬性： + Attributes (object) + data (array) + (object) + id: 100 (number) - The ID for the particular EPG object + title: "Vik

0熱度

2回答

API藍圖：語義問題

在我的藍圖，我定義的數據結構，並嘗試使用它像在文檔的末尾，以便 + Attributes + error: (Error Details, required) 數據結構定義「沒有指定值（S）」： # Data Structures ## Error Details + code : 1234 (number, required) - see list of error cod

3熱度

1回答

在Apiary.io的API藍圖中使用通用命名類型

如何在我的API藍圖定義中使用generic named type？我嘗試這樣的： FORMAT: 1A HOST: http://test.com/ # API Blueprint testing. ## Resource [/resources] ### Action [GET] + Response 200 (application/json) + Attribu

0熱度

1回答

apiary.io作爲非託管解決方案提供嗎？

可以將apiary.io作爲純粹的私有內部部署解決方案使用，而不是提供託管解決方案嗎？

0熱度

1回答

API藍圖 - 使用數據結構作爲響應，無屬性

我正在使用Apiary模擬出一個新的API。我試圖避免一遍又一遍地寫出所有的JSON響應。如果我使用+ Attributes(user)這樣做，那麼它會在機器面板中自動生成一堆屬性塊，這在我的腦海中是非常令人困惑的（特別是當您有多個響應時）。如果您手動輸出JSON請求/響應塊，則生成的文檔看起來會更好。有沒有辦法將請求/響應對象存儲爲數據結構？也許是一個模型？我很想能夠做到這樣的事情： #

4熱度

2回答

API藍圖 - 避免重複授權塊

在API藍圖中，我該如何避免對每個端點反覆使用相同的請求授權標題塊？ + Request (application/json) + Headers Authorization: Bearer jsonWebToken 有沒有辦法在數據結構中模擬這個呢？

4熱度

1回答

如何在Swagger中爲內容類型：text/html的Response Body提供示例值

我有一個響應200 OK並返回HTML的API調用。我想將其添加到我的API文檔（特別是因爲我使用dredd進行了驗證，除非我提供它與期望的響應正文測試失敗）。如何我會在Swagger中做到這一點？ ---更多細節--- 我通過API調用的響應是200 OK，並有一行響應體： <html><body>You are being <a href="https://my.domain.com/us

1熱度

1回答

如果我在URL中指定API版本，我是否應該提供一個選項以將它放在標題中？

我設計我的API，我在URL GET /Issuer/{certificate-name}/versions?api-version=2016-10-01[&maxresults] 我也應該有一個在HTTP標頭（靈活性）指定指定一個可選的API版本？如果兩種方法之間存在衝突，我該怎麼辦？