2014-09-25 75 views
4

我花了幾天試圖瞭解我是否應該使用API​​藍圖,錯構瘤或招搖。究竟是什麼招搖?爲什麼在線編輯器不能運行請求?

看起來swagger擁有最大的社區,但越接近我越覺得它在文檔中缺少很多(我被迫多次查看代碼以嘗試將其與當前項目集成在一起),許多github問題和stackoverflow問題沒有答案。

難道我在這裏失去了一些東西? 我只需要一個工具來幫助我編寫API文檔並測試端點。

爲什麼一定要昂首闊步成爲服務器邏輯的一部分?如果我在the editor創建招搖文件,然後爲他們服務到UI直接折斷..

至於我可以告訴它甚至使服務器稍慢,並迫使許多笨拙地保持積分的存在:我I P什麼在這裏失蹤?

回答

4

我們正在努力工作了很多改善揚鞭的文檔。當許多項目都是由社區驅動,而不是由單一組織管理時,這會有點困難。

我們真正嘗試迅速回復問題在github上(我們並不總是成功),我們有我們自己的谷歌小組的一般性問題,所以我們遵循計算器稍差。

你提到的編輯器是一個新工具,對揚鞭2.0工作的一部分,它不是決賽。因此,它仍然有一些缺陷和缺少的功能。用戶界面也正在適應Swagger 2.0,同樣的限制也適用於它。

你肯定沒有把它與你的服務器整合,可以靜態暴露的文檔。將其與服務器集成的優勢在於,如果API發生更改,則更易於維護。

4

您可以嘗試RAML + ramlev + Abao

的步驟應該是錯構瘤

  • 寫API規範與你喜歡的編輯器,即。原子,VIM
  • 驗證你的腎錯構瘤與ramlev
  • 根據API規格實現服務器邏輯
  • 驗證服務器的邏輯與阿寶