【发布时间】：2013-08-07 08:59:32
【问题描述】：
在工作中，我和我的同事使用生气 SOA。我们不使用 WS，更喜欢 REST 和一些基于二进制和 JSON 的协议。因此，我们没有服务接口的 WSDL 方案。 我们在向开发人员提供有关服务的信息时遇到了问题，因为他们使用不同的语言进行编码，并且并不总是提供有关所有服务的信息。 问题是 - 如何解决这个问题？ 组织 wiki 系统，分别描述每个服务？在服务注册表中存储类似 wsdl 的定义？最好的方法是什么？
【问题讨论】：
-
在这种情况下，记录所有内容是开发人员最重要的提要。网址、输入输出、请求设置（get/post）任何东西都比没有好。
-
我个人喜欢使用静态站点生成器 nanoc (nanoc.ws) 构建的 GitHub api (developer.github.com/v3)。但是您可能追求圣杯并想要一个自动生成的、始终保持最新的版本。不确定，您是否查看了mattsilverman.com/2013/02/… 的 api 文档工具列表？
标签： soa