postman教程-5-发送put请求

news2024/12/25 9:14:14

领取资料，咨询答疑，请➕wei: June__Go

上一小节我们学习了postman发送post请求的方法，本小节我们讲解一下postman发送put请求的方法。

HTTP PUT 请求是一种用于传输数据的网络协议方法，它在客户端和服务器之间的通信中扮演着重要角色。

定义

PUT 是 HTTP/1.1 协议（RFC 7231）定义的一种方法，用于向服务器发送请求，以便更新服务器上的现有资源或创建一个新资源。如果指定的资源不存在，一些服务器可能会创建它；如果资源已存在，它将被更新。

幂等性

PUT 请求是幂等的，这意味着多次执行同一个 PUT 请求（使用相同的请求 URI 和相同的请求负载）应该不改变资源状态，并且不会产生副作用。换句话说，无论请求被执行多少次，结果都应该是相同的。

请求 URI

PUT 请求通常与特定的 URI（统一资源标识符）一起使用，该 URI 唯一地标识了要更新的资源。

请求体

PUT 请求的请求体包含要更新资源的新状态信息。这通常是一个表单或 JSON 数据，取决于 Content-Type 头部的值。

常见用途

更新服务器上的现有资源。
如果资源不存在，可以在服务器上创建一个新资源。
实现某些类型的业务逻辑，如用户配置文件更新。

HTTP 状态码

PUT 请求可能会触发多种 HTTP 状态码：

200 OK：请求成功，资源已被更新。
201 Created：请求成功，并且资源已被创建。
204 No Content：请求成功，但响应不包含内容（例如，当请求导致状态更改但没有新内容时）。
400 Bad Request：请求无效，如请求体格式错误。
401 Unauthorized：请求未授权。
403 Forbidden：服务器理解请求，但拒绝执行。
404 Not Found：请求的资源在服务器上未找到。
409 Conflict：请求无法被服务器完成，例如，当资源版本号冲突时。

安全性

由于 PUT 请求可以修改服务器上的数据，通常需要适当的认证和授权。服务器应该验证请求的合法性，并确保只有授权用户才能更新资源。

接口示例：

URI: http://dummy.restapiexample.com/api/v1/update/21
Method: PUT
Headers: Content-type: application/json

请求体:

{ "name": "Jenette Caldwell","salary": "2000","age": "15"}

使用curl的示例命令:

curl -X PUT http://dummy.restapiexample.com/api/v1/update/21 \
     -H "Content-type: application/json" \
     -d '{ "name": "Jenette Caldwell","salary": "2000","age": "15"}'

这个请求会尝试更新ID为21的员工的薪水和年龄。

成功响应示例：

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
    "status": "success",
    "data": {
        "name": "Jenette Caldwell",
        "salary": "2000",
        "age": "15"
    },
    "message": "Successfully! Record has been updated."
}

postman发送PUT请求