编者按：我们已经更新了一本关于这个博客系列中所涉及主题的电子书：webapi设计：缺失的链接。

在之前关于实用restapi设计的讨论中，我谈到了简化关联，使用HTTP？隐藏复杂性和可选参数，选择复数名词和具体名称等等。

RESTfulAPI最佳实践中的错误是什么？许多软件开发人员，包括我自己，并不总是喜欢考虑异常和错误处理，但这对于任何软件开发人员来说都是一个非常重要的难题，尤其是对于API设计人员来说？

归根结底，这是为了让你的API更直观，让开发者更成功。

首先，开发人员学会在错误中编写代码。极限编程模型的"测试优先"概念和最近的"测试驱动开发"模型代表了一系列最佳实践，这些实践不断发展，因为这对于开发人员来说是一种非常重要和自然的工作方式。

从开发人员使用Web的角度来看API，接口另一端的所有东西都是一个黑匣子。因此，错误成为提供上下文和如何使用API的可见性的关键工具。

其次，除了在开发应用程序时，当开发人员使用您的API构建的应用程序交到用户手中后，他们在解决问题和排除问题的关键时刻依赖于精心设计的错误。

如何用REST以务实的方式思考错误？

让我们看看三个顶级API是如何实现的。