HEAD request method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức HTTP HEAD yêu cầu siêu dữ liệu của một tài nguyên dưới dạng các tiêu đề mà máy chủ sẽ gửi nếu phương thức GET được sử dụng thay thế.
Phương thức này có thể được dùng trong các trường hợp một URL có thể tạo ra tải xuống lớn; ví dụ, yêu cầu HEAD có thể đọc tiêu đề Content-Length để kiểm tra kích thước tệp trước khi tải tệp xuống bằng GET.
Nếu phản hồi cho yêu cầu HEAD cho thấy một URL đã lưu trong bộ đệm hiện đã lỗi thời, bản sao được lưu trong bộ đệm sẽ bị vô hiệu hóa ngay cả khi không có yêu cầu GET nào được thực hiện.
Warning:
Nếu phản hồi cho yêu cầu HEAD có phần thân, phần thân phản hồi phải bị bỏ qua.
Bất kỳ tiêu đề biểu diễn nào mô tả phần thân sai đó được coi là mô tả phần thân phản hồi mà yêu cầu GET sẽ nhận được.
| Yêu cầu có phần thân | Không |
|---|---|
| Phản hồi thành công có phần thân | Không |
| An toàn | Có |
| Bất biến | Có |
| Có thể lưu đệm | Có |
| Cho phép trong HTML forms | Không |
Cú pháp
HEAD <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ặpkey=value.
Ví dụ
Lấy siêu dữ liệu tài nguyên thành công
Lệnh curl sau tạo một yêu cầu HEAD cho example.com:
curl --head example.com
Đây tương đương với yêu cầu GET, ngoại trừ máy chủ không nên đưa vào phần thân thông điệp trong phản hồi.
Nó tạo ra một yêu cầu HTTP trông như thế này:
HEAD / HTTP/1.1
Host: example.com
User-Agent: curl/8.6.0
Accept: */*
Máy chủ gửi lại phản hồi 200 OK chỉ gồm các tiêu đề.
Phản hồi thực chất là siêu dữ liệu mô tả tài nguyên thay vì bản thân tài nguyên (một số tiêu đề bộ đệm được bỏ qua trong ví dụ này để ngắn gọn):
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Wed, 04 Sep 2024 10:33:11 GMT
Content-Length: 1234567
Đặc tả
| Thông số kỹ thuật |
|---|
| HTTP Semantics # HEAD |