2013-08-07 92 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

回答