2013-08-07 132 views
0

在工作中,我和我的同事使用了異質SOA。我們不使用WS,更喜歡REST和一些基於二進制和JSON的協議。由於它,我們沒有我們的服務接口的WSDL方案。 我們面臨的問題是向我們的開發人員提供有關服務的信息,導致他們使用不同的語言編碼,而不是始終提供有關所有服務的信息。 問題是 - 如何解決這個問題? 組織wiki系統,分別描述每個服務?在服務註冊表中存儲wsdl-like的定義?什麼是最好的方法?SOA:服務API發現

+0

在這種情況下,記錄一切是開發商最重要的飼料。網址,輸入輸出,請求設置(get/post)任何東西都會比沒有東西更重要。 – mtsiakiris

+0

我個人喜歡GitHub api(http://developer.github.com/v3/),它使用一個靜態站點生成器nanoc(http://nanoc.ws/)構建。 但是你可能是在聖盃之後,想要一個自動生成的,總是最新的版本。不知道,您是否在http://www.mattsilverman.com/2013/02/tools-to-generate-beautiful-api-documentation.html查看api文檔工具列表? – AardVark71

回答