清风徐来，水波不兴

原文作者Mathieu Fenniak在博文中大呼：不要再设计易碎的Web API 了，否则你的合作伙伴或第三方开发者会因此恨你，而离你远去的。他认为，想设计出相对稳定、牢固的API，关键在于以应用目的为中心。文中还分享了设计优秀API需要注意的几点事项，我们一起来看下： 如果破坏了API，客户会因此而恨你 很多Web API发布后，它就像被牢牢刻在石头上无法做出兼容改变，这是个可怕的现象。倘

人们在如何设计一款优秀的API上有着很强烈的意识。在互联网上有关API方面的网页和书籍有很多很多。本文我们将重点关注设计优秀API的规则。 规则就是当发生任何变化时，应当遵循“最小惊奇原则”。无论你想尝试什么样的个人风格或者品味，你都可以添加到API中，因此，这是优秀的API理应具备的特性之一。 设计“正规”API理应注意的几件事情： 规则1：建立强有力的条款 随着API的不断增长，这

移动App与基于Web/云服务发生对话是很常见的事情，最简单的可能仅仅只是检索数据，但也可能包含发送数据、用户授权和管理。而这也就验证了为移动应用建立API的重要性，为此，我们特总结了10大移动API设计技巧。 1. API版本控制 无论何时，开发者要想保证应用正常运转，对API进行修改总是不可避免的，可能只是对某些功能执行添加、删除或其他操作。当遇到这种情况时，你就不得不暂停API部

近日，酷壳网陈皓与支付宝前端负责人玉伯在微博上发起了关于API设计的话题。陈皓表示，有两点是前端工程都需要认真考虑的：1）一些API最好支持批量数据处理，而不是让人一次一次地掉用，2）需要考虑多个API间的关联性，可以降低使用方的工作量。对此支付宝前端负责人玉伯分享了他的看法： 延续大前天的话题，陈皓在微博中提到： 【如何设计JS API？】我觉得有两点各个前端工程需要认真考虑：1）我们的

API by thesmith 俗话说：“好东西就要贡献出来和大家一起分享”，尤其是在互联网业务高度发达的今天，如果你的创业公司提供了一项很酷的技术或者服务，并且其他用户也非常喜欢该产品，在这种情况下，最好的解决方案是什么呢？把它作为一项服务——通过RESTful API的形式进行开放共享。 嗨，别忘了，如果这样做，未来它或许会像Twitter那么有名。当然它可能也会给你带来些荣誉，或者会给你

最近在Filepicker.io上花了很多时间研究API，随着JavaScript API 1.0的发布，我们总结了API设计经验，分享给大家，希望我们在使用您的API时，也能像使用自己的API那样兴奋。 规则0：不要随意对API做出改变 API是你与产品使用者沟通合作的桥梁，好比合同，请不要轻易修改和违背。开发者会花时间和精力学习研究你的API，并且把它们融入到自己的产品中。 然而，随着时

编写技术文档，是令众多开发者望而生畏的任务之一。它本身是一件费时费力才能做好的工作。可是大多数时候，人们却总是想抄抄捷径，这样做的结果往往非常令人遗憾的，因为优质的技术文档是决定你的项目是否引人关注的重要因素。无论开源产品或面向开发者的产品，均是如此。 实际上，我想说明的是：对于面向开发者的产品来说，其用户体验中最重要的一环并不是什么主页设计、登录过程、或者SDK下载。真正最重要的是产品的API