RESTful API 中优雅地处理软删除是 API 设计中的一个关键考量。本文探讨在 RESTful 风格下实现软删除和物理删除的最佳实践，并分析各种方法的优劣。
许多开发者在选择 HTTP 方法时犹豫不决。软删除并非真正的删除，而是数据状态的修改，因此选择 DELETE、PUT 或 PATCH 方法都存在争议。本文将探讨几种方案，包括使用 PUT 或 PATCH 更新 deleted 字段，以及使用 DELETE 方法结合请求体参数区分软删除和物理删除。 不推荐使用 POST 方法，因为它违反了 RESTful 原则。
从客户端（例如前端）角度来看，软删除仍然是“删除”操作，客户端无需了解后端实现细节。因此，建议使用 DELETE 方法作为默认的删除操作，这更符合 RESTful 语义。 如果需要物理删除，可在 DELETE 请求的请求体中添加参数，例如 {"force": true}，指示服务器执行物理删除。 服务器端需进行权限验证，确保只有授权用户才能执行物理删除。
示例：DELETE /v1/user/1234 表示软删除；DELETE /v1/user/1234 并携带 {"force": true} 表示物理删除。 此方法简洁明了，符合 RESTful API 的直觉，优于使用 PUT 或 PATCH 方法。 文章也分析了使用 POST 方法等非 RESTful 方法的不足。
