公共API：放手数据，迎接世界

明确的重要性

另一大成功要求则在于提供丰富且明确的文档及工具，借以帮助开发商完成工作。彭博资讯公司最初提供的说明文档就将着眼点放在了金融专家这一主要客户群体身上，最终他们不得不重新编辑以帮助开发人员理解自己需要注意的事项。

“API是连接彭博云体系的软件的组成部分，”彭博资讯公司首席 技术官Shawn Edwards指出。“我们不会泄露市场数据，这样做是为了让外部应用能够与其它服务相结合。”

BLPAPI即将提供回放工具以帮助开发商简化工作流程，这套工具允许他们对创建出的应用产品进行试运行。百思买集团的BBYOpen也为开发商提供了一系列工具，其中包括应用测试控制台以及自动化工具生成器。世界银行则提供了一款查询生成器，允许开发人员制作各类查询选项。

工具与灵感并不完全由内向外发散；外部开发商也经常为API拥有企业提供信息及框架支持。举例来说，BBYOpen的开发者们就创建了一套涵盖Java、.NET、PHP及其它多种语言的库。在世界银行方面，开发商自发建立了一套论坛，帮助遇到难题的技术人员从其它公司处寻找解决方案。

“他们并不会坐等我们在论坛上对问题做出回应，”致力于将该论坛打造成更具功能性及知识库体系的Veerappan指出。“很高兴看到其他开发者能从API中获取更多知识，”她告诉我们。

成功的API往往遵循麻省理工学院的开源软件许可条款；以世界银行为例，他们使用的就是开源署名许可。O’Grady指出获得成功的关键之一在于对服务条款的明确表述，并避免由于许可内容过分严厉而打消开发者的使用积极性。

以Stack Overflow为例，这是一家专门通过协作方式为程序员提供解答服务的站点。其API相当出色，但惟一的不足在于使用条款难于理解。他同时补充称，Twitter也是由于在某些问题上态度过于强硬而惹恼了开发商，例如时间标记该采取何种格式或者坚持“tweet”字样必须大写等。尽管开发商不太可能因为Twitter的暴躁风格而离它而去，但O’Grady认为“我们的产品显然达不到那么高的人气，所以在某些情况下开发者们确实会心灰意冷地选择放弃。”