在设计接口时，什么时候应该用路径参数，什么时候将数据保存到方法体中，它们各自的优势是什么？

在设计 RESTful API 接口时，选择将数据放在路径参数（Path Parameters）还是方法体（Request Body）中，取决于具体的需求和使用场景。每种方式都有其优势和适用的场景。

路径参数（Path Parameters）

适用场景

• 唯一标识符：当你需要通过一个唯一的标识符来定位资源时，例如获取、更新或删除特定资源。
• 固定结构：路径参数通常用于表示固定的、不可变的数据结构。

优势

1. 可读性和语义性：路径参数使得 URL 更具可读性和语义性。例如，/students/123 明确表示请求的是 ID 为 123 的学生资源。
2. 缓存友好：由于路径参数是 URL 的一部分，可以更容易地被缓存机制识别和处理。
3. 安全性：路径参数不会出现在服务器日志中，因此对于敏感信息来说更为安全。
4. 简单查询：对于简单的查询操作，路径参数更为直观和简洁。

示例

• 获取特定学生的信息：

  GET /students/{id}

• 删除特定学生的信息：

  DELETE /students/{id}

方法体（Request Body）

适用场景

• 复杂数据：当需要传递复杂的数据结构或大量数据时，例如创建或更新资源。
• 动态数据：方法体适用于需要传递动态或可变的数据的情况。

优势

1. 灵活性：方法体可以包含任意复杂的 JSON 对象，适合传递大量或复杂的数据。
2. 安全性：对于敏感信息，方法体可以通过 HTTPS 加密传输，确保数据的安全性。
3. 易于扩展：方法体中的数据结构可以很容易地进行扩展和修改，而无需改变 URL 结构。
4. 减少 URL 长度：避免 URL 过长的问题，特别是当需要传递大量数据时。

示例

• 创建一个新的学生记录：

  POST /students
  Request Body:
  {
    "name": "张三",
    "sex": "男",
    "age": 20
  }

• 更新特定学生的信息：

  PUT /students/{id}
  Request Body:
  {
    "name": "李四",
    "sex": "女",
    "age": 22
  }

总结

• 路径参数 适用于唯一标识符和固定结构的数据，具有更好的可读性和缓存友好性。
• 方法体 适用于复杂和动态的数据，具有更高的灵活性和安全性。

实践使用

1. GET 请求：通常只使用路径参数和查询参数，不使用方法体。因为 GET 请求是幂等的，不应该有副作用。

   • 获取资源列表：GET /students
   • 获取特定资源：GET /students/{id}

2. POST 请求：用于创建新资源，数据通常放在方法体中。

   • 创建新资源：POST /students

     {
       "name": "张三",
       "sex": "男",
       "age": 20
     }

3. PUT 和 PATCH 请求：用于更新资源，数据通常放在方法体中。

   • 更新特定资源：PUT /students/{id}

     {
       "name": "李四",
       "sex": "女",
       "age": 22
     }

4. DELETE 请求：用于删除资源，通常只需要路径参数。

   • 删除特定资源：DELETE /students/{id}

通过合理选择路径参数和方法体，可以使你的 API 设计更加清晰、易用和高效。