Tài liệu tham khảo dễ quét cho mọi phương thức yêu cầu HTTP — GET, POST, PUT, PATCH, DELETE và các phương thức còn lại, cùng WebDAV — cho thấy ngay mỗi phương thức có an toàn, lũy đẳng và có thể cache hay không, có mang body hay không, kèm một ví dụ điển hình. Trong trình duyệt, miễn phí.

Mọi phương thức yêu cầu HTTP chuẩn và ngữ nghĩa của nó, đặt cạnh nhau. Tất cả chạy trong trình duyệt của bạn từ một tham chiếu tích hợp — không có gì gửi lên máy chủ.

Phương thức Mục đích An toàn Lũy đẳng Có thể cache Body Sử dụng điển hình
Không có phương thức nào khớp tìm kiếm của bạn.
Thử một tên hoặc thuật ngữ khác — ví dụ PATCH, idempotent hoặc cache.
Không Có điều kiện Tuỳ chọn Không khuyến khích

Giới thiệu về Phương thức HTTP

Tài liệu tham khảo phương thức HTTP này đưa mọi phương thức yêu cầu chuẩn — GET, HEAD, POST, PUT, PATCH, DELETE, CONNECT, OPTIONS và TRACE — cùng các phần mở rộng WebDAV phổ biến vào một bảng dễ tra cứu. Với mỗi phương thức, nó trả lời các câu hỏi mà nhà phát triển thực sự cần cân nhắc: có an toàn (safe) không, có bất biến (idempotent) không, có thể lưu cache không, có mang theo phần thân yêu cầu không, và cách dùng điển hình trông như thế nào.

Ba tính chất ngữ nghĩa đó thúc đẩy các quyết định thiết kế thực tế. Các phương thức an toàn chỉ đọc và có thể được tải trước tự do; các phương thức bất biến có thể thử lại sau lỗi mạng mà không gây tác dụng phụ, đúng như những gì proxy và HTTP client giả định; và khả năng lưu cache quyết định liệu phản hồi có thể được lưu trữ và tái sử dụng hay không.

Tìm kiếm khớp với tên phương thức, tính chất và trường hợp sử dụng — PATCH, idempotent và cache đều lọc được bảng — và một nút chuyển nhóm tách các phương thức chuẩn khỏi tập WebDAV. Mỗi tên phương thức được sao chép vào clipboard chỉ với một cú nhấp.

Cách sử dụng Phương thức HTTP

  1. Quét qua bảng để so sánh các phương thức theo các cột Safe, Idempotent, Cacheable và Body.
  2. Tìm kiếm theo tên, tính chất hoặc trường hợp sử dụng — ví dụ PUT, idempotent hoặc upload.
  3. Chuyển đổi giữa nhóm Standard và WebDAV để bao gồm hoặc loại trừ các phương thức mở rộng.
  4. Di chuột lên chú giải cột để xem định nghĩa dễ hiểu của mỗi tính chất.
  5. Nhấp nút sao chép để lấy tên phương thức cho đặc tả API hoặc bài kiểm tra của bạn.

Câu hỏi thường gặp

Safe nghĩa là yêu cầu hoàn toàn không thay đổi trạng thái máy chủ — GET và HEAD chỉ đọc. Idempotent nghĩa là lặp lại yêu cầu giống hệt sẽ có cùng tác dụng như gửi một lần — DELETE là idempotent nhưng không safe, vì lần gọi đầu tiên đã làm thay đổi trạng thái.

PUT thay thế toàn bộ tài nguyên bằng nội dung bạn gửi và có tính idempotent. PATCH áp dụng thay đổi một phần — chỉ những trường bạn gửi lên mới thay đổi — và không được đảm bảo idempotent. Dùng PUT cho các thay thế toàn phần và PATCH cho các cập nhật có mục tiêu.

Vì client, proxy và SDK tự động thử lại các yêu cầu idempotent sau khi hết thời gian chờ hoặc mất kết nối. Một POST không idempotent bị thử lại mù quáng có thể tạo ra đơn hàng hoặc bản ghi trùng lặp, đó là lý do các API thanh toán kết hợp POST với khóa idempotency.

Phản hồi của GET và HEAD có thể lưu cache mặc định. Phản hồi của POST chỉ có thể lưu cache khi có tiêu đề độ tươi tường minh cho phép, điều hiếm gặp trong thực tế. Các phương thức khác không thể lưu cache — phản hồi của chúng không được lưu trữ và tái sử dụng.

WebDAV mở rộng HTTP để quản lý tệp từ xa, bổ sung các phương thức như PROPFIND, MKCOL, COPY, MOVE, LOCK và UNLOCK. Bạn sẽ gặp chúng khi làm việc với máy chủ WebDAV, các giao thức lịch/danh bạ xây dựng trên đó, hoặc tích hợp ổ đĩa mạng.

Có. Toàn bộ bảng miễn phí và chạy trong trình duyệt của bạn từ một tập dữ liệu tích hợp sẵn — tìm kiếm và lọc không gửi gì lên máy chủ.

Cần trợ giúp?
Gặp sự cố với công cụ này? Hãy cho đội ngũ của chúng tôi biết.
Báo cáo sự cố

Thêm công cụ miễn phí này vào trang web của riêng bạn — sao chép và dán mã bên dưới.