
理解GET和POST请求以及如何有效运用查询参数(req.query)和路由参数(req.params)是构建健壮API的关键。
GET请求
GET请求用于从服务器获取数据,类似于提出问题,不会修改服务器状态。
<code class="javascript">// 客户端请求:
fetch('https://api.example.com/users?id=123');
// 服务器端:
app.get('/users', (req, res) => {
const { id } = req.query; // 获取查询参数
res.send(`用户数据,ID: ${id}`);
});</code>GET请求特点:
POST请求
当需要向服务器发送数据以创建或更新资源时,使用POST请求。
<code class="javascript">// 客户端请求:
fetch('https://api.example.com/users', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: 'John', age: 30 }),
});
// 服务器端:
app.post('/users', (req, res) => {
const { name, age } = req.body; // 获取POST请求体数据
res.send(`创建用户 ${name},年龄: ${age}`);
});</code>路由参数 (req.params)
路由参数是URL路径的一部分,用于标识特定资源,在路由定义中用冒号(:)表示。
<code class="javascript">// 路由定义:
app.get('/user/:id', (req, res) => {
const { id } = req.params; // 从路由中提取ID
res.send(`用户ID: ${id}`);
});
// 客户端请求:
fetch('https://api.example.com/user/123');</code>在这个例子中,123 成为 id 参数,用于标识所需资源。
查询参数 (req.query)
查询参数位于URL的?之后,用于传递可选数据或过滤器。
<code class="javascript">// 路由定义:
app.get('/users', (req, res) => {
const { rateLimit, page } = req.query; // 获取查询参数
res.send(`速率限制: ${rateLimit}, 页码: ${page}`);
});
// 客户端请求:
fetch('https://api.example.com/users?rateLimit=50&page=2');</code>组合使用路由参数和查询参数
可以同时使用路由参数和查询参数来创建更精确的请求:
<code class="javascript">// 路由定义:
app.get('/user/:id', (req, res) => {
const { id } = req.params; // 路由参数
const { details } = req.query; // 查询参数
res.send(`用户ID: ${id}, 详情: ${details}`);
});
// 客户端请求:
fetch('https://api.example.com/user/123?details=full');</code>快速参考表
| 特性 | 路由参数 (req.params) | 查询参数 (req.query) |
|---|---|---|
| 目的 | 标识特定资源 | 提供附加信息 |
| 位置 | 定义在URL路径中 | 附加在URL的?之后 |
| 是否必需 | 是 | 否 |
| 示例 | /user/:id |
/users?rateLimit=50 |
最佳实践
总结
理解何时使用路由参数和查询参数对于创建直观且易于维护的API至关重要。路由参数擅长标识资源,而查询参数提供了数据检索的灵活性。两者结合,构成了强大的API设计工具集,有助于构建有效的RESTful API。
以上就是掌握get和在API中发布:路由参数与查询参数的详细内容,更多请关注php中文网其它相关文章!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号