Tài Liệu Tham Chiếu Mã Trạng Thái HTTP miễn phí

Được sử dụng cho các yêu cầu có Expect: 100-continue. Máy chủ xác nhận rằng nó sẵn sàng nhận phần nội dung trước khi khách hàng gửi nó. Hiếm khi thấy trong các ứng dụng web hiện đại.

Thường được sử dụng nhất để nâng cấp WebSocket — khách hàng yêu cầu Upgrade: websocket và máy chủ phản hồi 101 để chuyển đổi.

Phản hồi sơ bộ WebDAV được gửi để ngăn chặn thời gian chờ của khách hàng trong quá trình hoạt động dài. Không dùng nữa — các máy chủ hiện đại không nên gửi nó.

Cho phép các máy chủ gửi các tiêu đề Link (preload/preconnect) trong khi phản hồi cuối cùng vẫn đang được chuẩn bị, vì vậy trình duyệt có thể bắt đầu tìm nạp các tài sản quan trọng sớm hơn.

Phản hồi thành công tiêu chuẩn. Ý nghĩa tùy thuộc vào phương thức HTTP: GET → tài nguyên được trả về, POST/PUT → hành động hoàn tất.

Thường gặp sau một POST. Phản hồi nên bao gồm tiêu đề Location chỉ đến URL của tài nguyên mới.

Đối với các hoạt động không đồng bộ — máy chủ đang xếp hàng công việc. Khách hàng nên thăm dò một điểm cuối trạng thái hoặc kiểm tra lại sau.

Yêu cầu thành công, nhưng một trung gian (chẳng hạn như proxy lưu trữ hoặc chuyển đổi) đã thay đổi tải trọng từ máy chủ gốc — ví dụ: nén lại hình ảnh. Hiếm khi xảy ra trong thực tế.

Thường được sử dụng cho các hoạt động DELETE hoặc cập nhật PUT không cần trả về phần nội dung. Khách hàng không nên rời khỏi trang hiện tại.

Giống như 204, không có phần nội dung được trả về — nhưng khách hàng cũng được thông báo rằng nên đặt lại biểu mẫu hoặc chế độ xem đã tạo ra yêu cầu (ví dụ: xóa các trường biểu mẫu cho mục nhập tiếp theo).

Phản hồi cho yêu cầu Range. Được sử dụng bởi các trình phát video và trình quản lý tải xuống để tiếp tục tải xuống bị gián đoạn hoặc truyền phát các tệp lớn.

WebDAV: phần nội dung XML báo cáo kết quả của nhiều hoạt động phụ độc lập — ví dụ: một lần di chuyển hàng loạt nơi một số mục thành công và những mục khác thất bại.

WebDAV: được sử dụng bên trong các phản hồi 207 Multi-Status để tránh liệt kê lại các thành viên của cùng một bộ sưu tập khi các liên kết tạo ra vòng lặp.

Mã hóa delta: máy chủ trả về một khác biệt so với phiên bản trước đó thay vì toàn bộ tài nguyên, tiết kiệm băng thông. Rất hiếm khi được thực hiện.

Máy chủ cung cấp nhiều tùy chọn (ví dụ: các định dạng hoặc ngôn ngữ khác nhau) và khách hàng nên chọn một. Hiếm khi được sử dụng, vì đàm phán nội dung tự động thường xử lý điều này.

Sử dụng cho các thay đổi URL vĩnh viễn — các công cụ tìm kiếm sẽ cập nhật chỉ mục của họ. Quyền SEO chuyển sang URL mới.

Cho biết chuyển hướng không phải vĩnh viễn. Bộ nhớ cache kém tích cực hơn so với 301. Sử dụng cho những thứ như 'yêu cầu đăng nhập, chuyển hướng đến /login'.

Được sử dụng sau các submission POST — phản hồi nói 'POST của bạn đã hoạt động, hãy xem URL GET này để kết quả'. Trình duyệt luôn GET URL mới.

Phản hồi cho yêu cầu có điều kiện (với các tiêu đề If-None-Match hoặc If-Modified-Since). Tiết kiệm băng thông — không trả về phần nội dung.

Nếu bản gốc là POST, chuyển hướng cũng sử dụng POST. Thay thế hiện đại cho 302 khi việc giữ nguyên phương thức là quan trọng.

Thay thế hiện đại cho 301 khi bạn muốn các yêu cầu POST vẫn là POST sau khi chuyển hướng.

Các nguyên nhân phổ biến: JSON được định dạng sai trong phần nội dung, tham số truy vấn không hợp lệ hoặc các trường bắt buộc bị thiếu. Kiểm tra phần nội dung yêu cầu và tiêu đề.

Khách hàng phải bao gồm thông tin xác thực (tiêu đề Authorization, cookie, token). 'Unauthorized' là một tên sai lệch — nó thực sự có nghĩa là 'không được xác thực'.

Ban đầu dự định cho các khoản thanh toán kỹ thuật số. Cách sử dụng hiện đại: API đôi khi trả về 402 khi người dùng vượt quá hạn ngạch trả phí của họ.

Khác với 401 — người dùng ĐÃ đăng nhập, nhưng tài khoản của họ không có quyền truy cập tài nguyên này. Kiểm tra logic vai trò/quyền.

URL sai, tài nguyên đã bị xóa hoặc chưa từng tồn tại. Các máy chủ đôi khi trả về 404 để ẩn rằng 403 sẽ chính xác hơn.

Ví dụ: yêu cầu GET tới một điểm cuối chỉ chấp nhận POST. Phản hồi nên bao gồm tiêu đề Allow liệt kê các phương thức hợp lệ.

Khách hàng yêu cầu loại nội dung, ngôn ngữ hoặc mã hóa (thông qua Accept, Accept-Language, Accept-Encoding) mà máy chủ không thể thỏa mãn. Nhiều máy chủ bỏ qua thương lượng nghiêm ngặt và trả về mặc định thay thế.

Giống như 401, nhưng được phát hành bởi một proxy: khách hàng phải gửi thông tin xác thực Proxy-Authorization. Thấy trên các mạng doanh nghiệp với các proxy xác thực.

Máy khách đã mất quá nhiều thời gian để gửi nội dung yêu cầu hoặc để kết nối ở trạng thái không hoạt động. Hãy thử gửi yêu cầu lại.

Thường được trả về cho xung đột chỉnh sửa đồng thời hoặc tạo tài nguyên trùng lặp (ví dụ: tạo người dùng với email đã tồn tại).

Mạnh hơn 404 — máy chủ biết rõ rằng tài nguyên ĐÃ tồn tại nhưng đã bị xóa vĩnh viễn. Các công cụ tìm kiếm sẽ loại bỏ khỏi chỉ mục.

Yêu cầu bị từ chối vì nó thiếu tiêu đề Content-Length và máy chủ từ chối nội dung có kích thước không xác định. Thêm tiêu đề và thử lại.

Được trả về khi các tiêu đề có điều kiện như If-Match hoặc If-Unmodified-Since không thành công — thường là khóa lạc quan: ai đó đã thay đổi tài nguyên kể từ phiên bản của bạn. Tải lại và thử lại.

Phổ biến khi tải lên các tệp lớn. Cấu hình máy chủ (nginx, apache) đặt kích thước phần thân tối đa. Kiểm tra cấu hình của máy chủ.

Thường được gây ra bởi các chuỗi truy vấn rất dài (ví dụ: mã hóa dữ liệu trong GET). Chuyển sang nội dung POST hoặc tăng giới hạn máy chủ nếu bạn kiểm soát nó.

Ví dụ: gửi application/xml đến máy chủ chỉ chấp nhận application/json. Đặt tiêu đề Content-Type chính xác.

Tiêu đề Range yêu cầu một phần mà tệp không có — ví dụ: tiếp tục tải về qua cuối tệp. Phản hồi nên bao gồm Content-Range với kích thước thực tế.

Được gửi khi máy chủ không hỗ trợ Expect: 100-continue. Một số máy khách gửi tiêu đề này theo mặc định trên các POST lớn; vô hiệu hóa nó thường khắc phục lỗi.

Một trò đùa Ngày Cá tháng Tư từ năm 1998 (RFC 2324). Một số API thực tế sử dụng nó cho các trò đùa hoặc để đánh dấu các điểm cuối không được dùng nữa. Không dùng cho sản xuất.

Phổ biến với tái sử dụng kết nối HTTP/2: yêu cầu đã đến máy chủ không được cấu hình cho tên máy chủ đích. Máy khách nên thử lại trên kết nối mới.

Ví dụ: JSON được phân tích cú pháp chính xác nhưng thiếu trường bắt buộc hoặc giá trị trường nằm ngoài phạm vi. Phổ biến trong phản hồi xác thực API REST.

WebDAV: tài nguyên nguồn hoặc đích bị khóa bởi máy khách khác, vì vậy không thể thực hiện thao tác. Chờ đợi để khóa được giải phóng hoặc phá vỡ nó bằng token thích hợp.

WebDAV: trong chuỗi các hoạt động phụ thuộc, hành động trước đó không thành công, vì vậy hành động này không được thực hiện. Tìm xem lỗi trước đó để biết nguyên nhân gốc rễ.

Liên quan đến TLS 1.3 0-RTT (dữ liệu sớm): máy chủ sẽ không mạo hiểm xử lý yêu cầu có thể được phát lại. Máy khách nên thử lại sau khi bắt tay hoàn tất.

Máy chủ từ chối phục vụ yêu cầu qua giao thức hiện tại nhưng sẽ thực hiện sau nâng cấp — phản hồi bao gồm tiêu đề Upgrade đặt tên giao thức cần thiết.

Máy chủ yêu cầu tiêu đề có điều kiện (như If-Match) để ngăn chặn xung đột mất cập nhật. Tải tài nguyên, ghi lại ETag của nó và gửi lại với If-Match.

Chậm lại. Phản hồi nên bao gồm tiêu đề Retry-After chỉ ra khi nên thử lại. Phổ biến với các API có hạn ngạch yêu cầu.

Một tiêu đề hoặc tổng kích thước tiêu đề vượt quá giới hạn — thường được gây ra bởi cookie quá lớn. Xóa cookie hoặc giảm những gì ứng dụng của bạn lưu trữ trong chúng.

Tài nguyên bị chặn vì lý do pháp lý — kiểm duyệt, lệnh tòa án hoặc quy định khu vực. Số này là tham chiếu đến cuốn tiểu thuyết Fahrenheit 451.

Một mục đích chung cho các lỗi phía máy chủ. Kiểm tra nhật ký máy chủ để tìm nguyên nhân thực tế: ngoại lệ không được xử lý, lỗi cơ sở dữ liệu, v.v.

Ví dụ: máy chủ không nhận dạng phương thức HTTP. Hiếm trong thực tế — thường bạn sẽ thấy 405.

Phổ biến trong kiến trúc vi dịch vụ. Bộ cân bằng tải hoặc máy chủ proxy ngược của bạn nhận được phản hồi không hợp lệ từ dịch vụ phía sau.

Hoặc đang bảo trì hoặc bị quá tải. Phản hồi nên bao gồm tiêu đề Retry-After. Thường được trả về trong các triển khai.

Dịch vụ phía sau không phản hồi đủ nhanh. Kiểm tra tình trạng dịch vụ phía trước và cấu hình hết thời gian chờ.

Phiên bản HTTP chính của yêu cầu không được máy chủ hỗ trợ. Hầu như không bao giờ được nhìn thấy với các máy khách hiện đại.

Thương lượng nội dung minh bạch kết thúc trong một vòng lặp: biến thể đã chọn tự nó được cấu hình để thương lượng. Chỉ ra lỗi cấu hình máy chủ.

Xuất phát từ WebDAV nhưng đôi khi được sử dụng bởi các máy chủ chung. Có nghĩa là máy chủ không thể lưu yêu cầu vì các ràng buộc lưu trữ.

WebDAV: xử lý yêu cầu Depth: infinity đã nhập một vòng lặp (ví dụ: ràng buộc tròn). Thao tác đã bị chấm dứt.

Từ HTTP Extension Framework lỗi thời: máy chủ cần thêm thông tin trước khi nó có thể hoàn thành yêu cầu. Hầu như không được sử dụng trên web hiện đại.

Được sử dụng bởi các cổng giam (WiFi khách sạn/sân bay) để chỉ ra rằng người dùng phải đăng nhập vào mạng trước khi truy cập các trang web bên ngoài.