NodeJS API更新删除：URL参数还是请求体传递ID？

在NodeJS开发API时，更新或删除条目时的ID传递方式，推荐优先使用URL参数，核心原因从API规范、可读性、团队协作角度出发，而非效率或安全性的显著差异，具体分析如下：

1. 符合RESTful API设计规范 #

REST的核心是「资源定位」——URL用来标识具体资源，HTTP方法（PUT/DELETE）定义对资源的操作。比如PUT /todos/123清晰表明是更新ID为123的待办事项，语义明确；而PUT /todos配合请求体里的ID，语义更偏向「批量更新」或「不明确的资源操作」，违背了资源定位的设计原则。

注意：你提供的URL参数实现代码有个小问题，路由需要写成/todos/:id才能正确获取req.params.id，修正后的代码：

// 更新待办事项
app.put('/todos/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const newTodoContent = req.body.todo;

  // 剩余代码
});

2. 代码效率与可读性 #

• 效率层面：两者几乎无差异。URL参数由Express直接解析，请求体依赖内置的express.json()中间件解析，但这两种操作的性能开销可以忽略不计，不会成为系统瓶颈。
• 可读性层面：URL参数的方式更直观，其他开发者看路由就能知道接口是操作单个资源，无需额外查看请求体结构；请求体传ID则需要确认请求体内容，增加了理解成本。

3. 安全性差异 #

两者没有本质的安全优劣：

• URL参数会被记录在服务器日志中，如果ID是敏感信息（如用户隐私ID），可能存在日志泄露风险，但普通业务ID（如待办ID）一般无需担心。
• 请求体里的ID在HTTPS传输下是加密的，且不会被日志记录，但如果使用HTTP传输，两者都存在明文泄露问题——所以关键是始终使用HTTPS，而非纠结ID的传递方式。

另外，浏览器对URL长度有一定限制，但ID通常是短字符串或数字，完全在限制范围内，不会影响使用。

关于「请求体传ID更简洁」的看法 #

简洁是主观感受，但从API的一致性和可维护性来看，URL参数的方式更利于团队协作：主流API设计工具（如Swagger、Postman）会自动识别URL参数，生成更清晰的文档和测试界面；同时也符合开发者的普遍认知，降低新人接手的学习成本。

内容的提问来源于stack exchange，提问作者CyberJ