在开发 RESTful API 中，请求头（request header）是很重要的一部分，它能够帮助开发者正确地处理客户端发送的请求，限制一些不必要的访问，增强 API 的安全性等等。在本文中，我们将探讨如何在 RESTful API 中正确地使用请求头信息。
请求头的作用
请求头是在 HTTP 请求中的一部分，它用于描述客户端发送给服务器的内容，包含了很多的信息，例如：
- Content-Type：描述了请求中发送的内容类型。
- Accept：描述了客户端所接受的响应类型。
- Authorization：用于在请求中传递认证信息。
- User-Agent：描述了客户端发送请求的用户代理信息。
- Referer：描述了当前页面的来源页面地址。
请求头信息对于开发者来说非常重要，它可以帮助我们更加精细地控制 API 服务的行为，加强安全性，限制不必要的资源访问等等。
如何在 RESTful API 中正确使用请求头信息
接下来我们将介绍一些在 RESTful API 中正确使用请求头信息的实践方法，包括：
1. 使用 Content-Type 和 Accept 头
Content-Type 请求头用于描述请求中发送的内容类型，例如：application/json、application/xml 等等。Accept 请求头则用于描述客户端期望服务端响应的内容类型。
在编写 RESTful API 时，我们可以根据客户端 Accept 请求头确定响应数据的类型，将不同的数据类型分别封装在不同的接口中，以提高 API 的适配性和可扩展性。例如：
-- -------------------- ---- -------
---------------------- ----- ---- -- -
-- --------------------- - -- -----
--------------------- - ----- ----- ----- ---- -- ---
- ---- -- --------------------- - -- -----
---------- ----- ----- ----- ---- -- ---
- ---- -
------------------------- -------------
-
---2. 使用 Authorization 头实现身份认证
Authorization 请求头可用于传递认证信息，例如基本认证、Bearer 认证等。我们可以通过验证 Authorization 头信息来对 API 进行身份认证，以确保只有合法用户才能访问某些接口。
例如，在一个需要身份认证才能访问的接口中我们可以这样使用 Authorization 头：
router.get('/profile', (req, res) => {
const authHeader = req.header('Authorization');
if (!authHeader) {
res.status(401).send('Unauthorized');
return;
}
// 进一步认证身份，例如通过 jwt 进行验证
});3. 使用 User-Agent 和 Referer 头实现安全控制
User-Agent 请求头描述了客户端发送请求的用户代理信息。使用 User-Agent 头我们可以判断是漏洞扫描器还是正常用户进行的访问，以便进行相应的限制和安全控制。
Referer 请求头描述了当前页面请求的来源页面地址，我们可以使用 Referer 头来实现跨站请求伪造（CSRF）的防御。
例如，在一个需要防御 CSRF 攻击的接口中，我们可以这样使用 Referer 头：
router.post('/updateProfile', (req, res) => {
if (req.headers.referer !== 'https://example.com/profile') {
res.status(403).send('Forbidden');
return;
}
// 更新用户信息……
});总结
在开发 RESTful API 中，请求头信息是非常重要的一部分。正确使用请求头可以帮助我们提高 API 的安全性，限制不必要的访问，增强 API 的适配性和可扩展性等等。在实际开发中，我们可以结合请求头信息和 API 的业务需求来进行不同的处理，以达到最佳的 API 使用效果。
参考文献
- MDN Web Docs: HTTP headers
- RESTful API Design: 13 Best Practices to Make Your Users Happy
- Securing your API using HTTP Headers
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64cc71075ad90b6d04283cb5