apiblueprint

1熱度

1回答

我試過了，並且遇到資源組問題。我嘗試創建一個自定義組「事件」並列出與事件相關的所有函數名稱。

1熱度

1回答

我正在嘗試編寫一個API並努力想出一個將自定義操作添加到資源的好方法。舉例來說，在我的用戶資源我想有行動enabled和disable，但通常的藍圖分組內我不能添加這些組下設：Disable a User和Update a User都指向 ## User [/users/{id}] ### Update a User [PATCH] ... ### Delete a User [

0熱度

1回答

如何生成redsnow

https://github.com/apiaryio/redsnow https://github.com/apiaryio/matter_compiler 我需要生成redsnow爲matter_compiler一個JSON/YAML JSON/YAML。我檢查了文檔&的代碼，但沒有找到它。現在有可能嗎？爲什麼我需要它：我想用test/specs中的數據生成apiblueprint-ma

2熱度

1回答

API藍圖 - 如何執行一個簡單的更新

我已經通過了Apiary的文檔，但沒有找到如何創建藍色打印來更新資源。我想在這裏實現的是一個簡單的場景，例如有一個用戶列表，能夠列出它們，通過id檢索單個用戶，爲該用戶定義不同的屬性，修改該用戶的一個n屬性用戶（更新該用戶）並刪除該用戶。有人可以將我重定向到一些明確的文檔或我在研究過程中遺漏的一個stackoverflow問題，這將幫助我實現這一目標嗎？

4熱度

2回答

究竟是什麼招搖？爲什麼在線編輯器不能運行請求？

我花了幾天試圖瞭解我是否應該使用API藍圖，錯構瘤或招搖。看起來swagger擁有最大的社區，但越接近我越覺得它在文檔中缺少很多（我被迫多次查看代碼以嘗試將其與當前項目集成在一起），許多github問題和stackoverflow問題沒有答案。難道我在這裏失去了一些東西？我只需要一個工具來幫助我編寫API文檔並測試端點。爲什麼一定要昂首闊步成爲服務器邏輯的一部分？如果我在the edi

0熱度

1回答

可以將唯一資源添加到目錄中嗎？

這 FORMAT: 1A HOST: something.com # Something API # Group Something Foobar description ## Some Route [/routeroute] Foobar description ### Some HTML Action [GET] + Response 200 (text/

4熱度

2回答

Apiary：有沒有一種方法來定義參數的選項？

我想定義蜂房參數選項，我目前列出他們在描述：測量= m（可選，字符串，m）...測量例如M =米，公里=公里，收率=碼，MI =英里

2熱度

1回答

對參數

的不同請求我想根據「名稱」或「狀態」搜索（比如說）「accounts」。所以我想有兩個動作： GET /persons/?q=name==Jea* GET /persons/?q=status==locked 我如何可以記錄呢？我試過一個Action以倍數交易： ### GET /accounts{?q} + Request by name +Parameters +

0熱度

1回答

鑑於API藍圖資源模型，我如何確保資源的只讀部分不可更新？

我有一個大的模型，我正在使用GET和PUT資源。該模型包括了「審計」的對象，像這樣： "audit": { "createdAt": "2014-04-14T02:15:15Z", "lastUpdatedAt": "2014-04-14T02:15:15Z", "deletedAt": "" } 這顯然是資源的只讀部分 -

3熱度

1回答

Blueprint API顯示響應正文中Enum的所有可能值

爲休息服務編寫API-Deocumentation時遇到了一個問題，我想列出所有可能作爲響應返回的值。在下面的情況下，它可能是「狀態」字段，它可能包含任何可能的枚舉值，我想總結哪些可能的狀態。我找不到一個簡單而好的方法來用apiblueprint做到這一點。有沒有辦法顯示默認情況下摺疊的部分，並在需要其他信息時展開它們？下面是示例代碼，我有： ## Sample [/Sample?{id}]