设计客户端API的最佳方法是什么？

我经常需要设计客户端API供其他程序员使用。该语言可以是Ruby、Java、Erlang和Javascript（Mootools）。有人对创建一个非常有用的API有什么建议吗。是的，这是一个非常主观的问题，我这样问是为了让我的API更容易被其他人使用。

看这个：

为了增加细节，这是一段由谷歌高级java bod Josh Bloch教授的演讲视频。如果你想在制作一个API

p >时考虑一下问题，那就太好了。

---

为了增加细节，这是一段由谷歌高级java bod Josh Bloch教授的演讲视频。如果你想在制定一个API

< P>时考虑一下问题，这是非常好的。我强烈建议遵循以下建议：它在和中提供。

我强烈建议遵循的建议：。它在和中提供。

一些想法：

• 使您的方法名称非常具有描述性
• 使用文档清楚地指示参数和返回值
• 跟随雅格尼亲吻
• 没有比代码示例更有用的了。。。它们涵盖了很多用例
一些想法：
• 使您的方法名称非常具有描述性
• 使用文档清楚地指示参数和返回值
• 跟随雅格尼亲吻
• 没有比代码示例更有用的了。。。它们涵盖了很多用例

---

我建议阅读以下来自Trolltech/Nokia的文章：

---

我建议阅读以下来自Trolltech/Nokia的文章：

---

如果您对一些非免费的替代品感兴趣，那么下面这本书将是一个很好的推荐：

---

如果您对一些非免费的替代品感兴趣，那么下面这本书将是一个很好的推荐：

---

如果您的主要目标之一是制作一个可用的API，或者换句话说，提供良好的开发人员体验，那么您可能应该查看此资源列表（API可用性和开发人员体验资源）：
如果您的主要目标之一是制作一个可用的API，或者换句话说，提供良好的开发人员体验，然后，也许您应该查看此资源列表（api可用性和开发人员体验资源）：
Dupe:谢谢，当我输入问题时，我没有看到另一个问题。Dupe:谢谢，当我输入问题时，我没有看到另一个问题。