为什么所有接口统一使用POST请求？详解HTTP请求方法及其幂等性

为什么所有接口统一使用POST请求？详解HTTP请求方法及其幂等性

引用

CSDN

1.

https://blog.csdn.net/qq_59670390/article/details/141937839

背景

在前后端接口设计中，规范的制定对于系统的稳定性和可维护性至关重要。以下是一些基本的设计原则：

1. 接口返回数据即显示：前端仅负责数据渲染，不涉及业务逻辑处理。
2. 渲染逻辑禁止跨多个接口调用：减少不必要的网络请求，提高性能。
3. 前端关注交互与渲染：避免在前端实现复杂的业务逻辑。
4. 数据格式统一：所有请求响应采用JSON格式，保持数据结构的简洁性。

基本格式

请求基本格式

根据公司规范，所有新接口统一使用POST请求。请求数据需要以JSON格式封装在请求体（body）中。例如：

{
    "username": "admin",
    "password": "123456",
    "captcha": "scfd",
    "rememberMe": 1
}

幂等性概念

在深入理解为什么选择POST请求之前，我们先来探讨一个核心概念——幂等性。

幂等性（Idempotence）是HTTP协议中的一个重要概念，指的是对同一资源的多次请求，如果请求的方法是幂等的，那么这些请求的效果应该与一次请求的效果相同，即多次请求不会对服务器上的资源状态产生不同的影响。

在HTTP协议中，GET、PUT、DELETE等方法被认为是幂等的，而POST、PATCH等方法则通常不被认为是幂等的。因此，幂等修改服务器状态，就是使用HTTP协议中幂等的方法（如PUT或DELETE）来对服务器上的资源进行修改，且这种修改操作在多次执行时，其效果与一次执行相同。

请求方法的选择

GET请求

• 特性：幂等且不修改服务器状态
• 用途：用于读取数据，如查询数据库中的记录或获取网页内容

PUT请求

• 特性：幂等且修改服务器状态
• 用途：用于更新资源，如更新用户信息或替换文件内容

POST请求

• 特性：不幂等且修改服务器状态
• 用途：用于创建新资源或执行某些需要处理数据的操作，如提交表单、上传文件等

总结

在编写HTTP请求时，选择GET、PUT、POST等不同的方法，主要是基于它们对服务器资源状态的影响以及它们是否满足幂等性的要求。GET请求因其幂等且不修改服务器状态的特点，被用于读取数据；PUT请求因其幂等且修改服务器状态的特点，被用于更新资源；而POST请求则因其不幂等但可以修改服务器状态的特点，被用于创建新资源或执行其他需要处理数据的操作。这样的选择有助于保持HTTP接口的一致性、安全性和易用性。