PATCH request method

Cú pháp

PATCH <request-target>["?"<query>] HTTP/1.1

<request-target>

Xác định tài nguyên đích của yêu cầu khi kết hợp với thông tin được cung cấp trong tiêu đề Host. Đây là đường dẫn tuyệt đối (ví dụ: /path/to/file.html) trong các yêu cầu đến máy chủ gốc, và là URL tuyệt đối trong các yêu cầu đến proxy (ví dụ: http://www.example.com/path/to/file.html).

<query> Optional

Thành phần truy vấn tùy chọn được đặt trước dấu hỏi ?. Thường được dùng để mang thông tin nhận dạng dưới dạng các cặp key=value.

Ví dụ

Sửa đổi tài nguyên thành công

Giả sử có một tài nguyên trên máy chủ đại diện cho người dùng với ID số là 123 theo định dạng sau:

{
  "firstName": "Example",
  "LastName": "User",
  "userId": 123,
  "signupDate": "2024-09-09T21:48:58Z",
  "status": "active",
  "registeredDevice": {
    "id": 1,
    "name": "personal",
    "manufacturer": {
      "name": "Hardware corp"
    }
  }
}

Thay vì gửi một đối tượng JSON để ghi đè hoàn toàn tài nguyên, PATCH chỉ sửa đổi các phần cụ thể của tài nguyên. Yêu cầu này cập nhật trường status:

PATCH /users/123 HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 27
Authorization: Bearer ABC123

{
  "status": "suspended"
}

Việc diễn giải và xác thực yêu cầu PATCH phụ thuộc vào cách triển khai. Thành công có thể được chỉ ra bởi bất kỳ mã trạng thái phản hồi thành công nào. Trong ví dụ này, 204 No Content được sử dụng vì không cần truyền phần thân với ngữ cảnh bổ sung về thao tác. ETag được cung cấp để người gọi có thể thực hiện yêu cầu có điều kiện trong tương lai:

HTTP/1.1 204 No Content
Content-Location: /users/123
ETag: "e0023aa4f"

Đặc tả

Khả năng tương thích với trình duyệt

Trình duyệt không sử dụng phương thức PATCH cho các hành động do người dùng khởi tạo, vì vậy "khả năng tương thích với trình duyệt" không áp dụng ở đây. Nhà phát triển có thể thiết lập phương thức yêu cầu này bằng fetch().

Xem thêm

• Các phương thức yêu cầu HTTP
• Mã trạng thái phản hồi HTTP
• Tiêu đề HTTP
• 204
• Tiêu đề Allow, Access-Control-Allow-Methods
• Accept-Patch – chỉ định các định dạng tài liệu patch được máy chủ chấp nhận
• JSON Patch Generator