十个书写Node.js REST API的最佳实践（上）

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

收录待用，修改转载已取得腾讯云授权

原文：10 Best Practices for Writing Node.js REST APIs

我们会通过本文介绍下书写Node.js REST API的最佳实践，包括各个主题，像是命名路由、认证、黑盒测试以及对相关资源使用合适的缓存头。

对于Node.js来说最流行的一个用例就是用其来书写RESTful API。尽管如此，当我们使用监控工具来帮助用户排查问题时，我们总是能感受到在REST API上开发者们有很多的问题。

我希望这些最佳实践能够对你有所帮助。

1. 使用HTTP方法和API路由

设想一下你正在构建Node.js RESTful API用以用来创建、更新、获取或者删除用户。这些操作HTTP已经有可以胜任的工具集：POST,PUT, GET, PATCH 或 DELETE。

作为最佳实践，你的API路由应该一直使用名词作为资源id。涉及到用的资源相关的，路由机制也可以这样：

POST /user 或者 PUT /user:/id 来创建新用户
GET /user 来获取列表的用户
GET /user/:id 来获得某一个用户
PATCH /user/:id 来修改已有的用户记录
DELETE /user/:id 来删除一个用户

2. 正确地使用HTTP状态码

如果处理请求时出了问题，你必须在响应里设置正确的状态码：

2xx，如果一切都ok
3xx，如果资源被移除
4xx，如果因为服务器错误导致请求无法实现 (例如请求一个不存在的资源)
5xx, 如果API测出现问题 (例如异常发生)

如果你正在使用Express，设置状态码就是这么简单 res.status(500).send({error: 'Internal server error happened'})。和使用Restify很类似：res.status(201).

查看list of HTTP status codes以寻求完整列表

3.使用HTTP头来设置Medata

使用HTTP头把metadata加到要发送的负载上。像这样的头可以是在如下信息的上：

页码
速率限制
或者是认证.

标准化HTTP头的列表可以在这里被找到。

如果你需要在你的相应头里面设置任何自定义的metadata，给它们加上X前缀是最佳实践。例如，之前如果你在使用CSRF token时，把其命名为X-Csrf-Token是很普遍（但不标准）的做法。无论如何随着RFC 6648的发布，这些都已经被废弃了。新API最好不要使用会和其他应用发生冲突的header名。例如，OpenStack在它们的header前加上了OpenStack：

OpenStack-Identity-Account-ID OpenStack-Networking-Host-Name OpenStack-Object-Storage-Policy

需要注意的是HTTP标准里并没有任何header尺寸限制的定义；然而，出于实际原因Node.js对header对象添加了80KB大小的限制。