介绍
RESTful API 是当前常见的网络应用之一。它为前端和后端开发者提供了一种灵活、可扩展的方式来构建 API。在构建 RESTful API 时,参数的传递方式十分重要。合理的参数传递方式可以有效提高开发效率和降低出错率。
URL 参数
在 RESTful API 中,URL 参数是最常见的一种传参方式。URL 参数是将参数直接附加在 URL 中,以“?”符号开始。下面是一个示例:
http://example.com/api/user?name=john&age=20
在这个示例中,参数是 name
和 age
。这些参数可以被直接通过 req.query
对象访问,如下所示:
app.get('/api/user', (req, res) => { const name = req.query.name; const age = req.query.age; // ... })
路径参数
路径参数是 RESTful API 的另一个常见传参方式。路径参数是将参数直接嵌入到 URL 路径中。下面是一个示例:
http://example.com/api/user/john/20
在这个示例中,john
是用户名称,20
是年龄。这些参数可以被直接通过 req.params
对象访问,如下所示:
app.get('/api/user/:name/:age', (req, res) => { const name = req.params.name; const age = req.params.age; // ... })
请求体参数
请求体参数是在 HTTP 请求体中传输的参数,通常使用 POST 或 PUT 请求。这种传参方式是安全的,因为参数不会暴露在 URL 中。请求体参数可以是 JSON 对象、XML、纯文本等格式。下面是一个示例:
app.post('/api/user', (req, res) => { const name = req.body.name; const age = req.body.age; // ... })
表单参数
表单参数是一种常见的参数传递方式,常用于 HTML 表单提交。表单参数是以键值对的形式提交的。表单参数也可以通过请求体传输,与 JSON 对象等格式不同。下面是一个示例:
app.post('/api/user', (req, res) => { const name = req.body.name; const age = req.body.age; // ... })
结论
RESTful API 支持的参数传递方式十分灵活,我们可以根据实际需求选择最合适的传递方式。需要注意的是,不同的传递方式适用于不同场景,选择最合适的传递方式可以提高开发效率和降低出错率。
参考
Understanding RESTful API Design: Part 1: Parameters
Node.js - Express Framework - Handling GET & POST Requests
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/677659686d66e0f9aa1f04d4