Tiêu đề Retry-After là một tiêu đề phản hồi HTTP cho biết cho một khách hàng biết phải chờ bao lâu trước khi thực hiện một yêu cầu tiếp theo. Một máy chủ có thể bao gồm nó trong phản hồi 429 Too Many Requests, mã trạng thái cho việc giới hạn tỷ lệ. Đối với một trình thu thập dữ liệu, tôn trọng giá trị này có nghĩa là tạm dừng trong thời gian mà máy chủ yêu cầu, thay vì đoán và có nguy cơ bị chặn thêm các yêu cầu.
Tiêu đề này là tùy chọn, vì vậy một phản hồi 429 có thể đến mà không có nó. RFC 6585 cũng không xác định cách mà một máy chủ xác định người dùng hoặc đếm các yêu cầu. Một giới hạn có thể liên quan đến thông tin đăng nhập hoặc cookie, không chỉ gắn liền với một địa chỉ IP.
Các định dạng giá trị Retry-After
- Thời gian trễ tính bằng giây: Một số nguyên không âm, chẳng hạn như
Retry-After: 120. - Ngày HTTP: Một ngày sau đó để thử lại, chẳng hạn như
Retry-After: Wed, 21 Oct 2015 07:28:00 GMT. - Nơi nó xuất hiện: Với các phản hồi 429, với 503 Service Unavailable để cho thấy thời gian gián đoạn nên kéo dài bao lâu, và với các chuyển hướng như 301 để đặt thời gian chờ tối thiểu.
Các tiêu đề giới hạn tỷ lệ khác
- Tiêu đề của nhà cung cấp: Một số API thêm các trường riêng của họ. Ví dụ, API REST của GitHub gửi
x-ratelimit-limit,x-ratelimit-remaining,x-ratelimit-usedvàx-ratelimit-reset. - Tiêu chuẩn đề xuất: Một dự thảo Internet của IETF định nghĩa các trường
RateLimitvàRateLimit-Policyđể các máy chủ có thể quảng bá chính sách hạn ngạch và hạn ngạch còn lại. Nó vẫn là một dự thảo, không phải là một RFC đã được xuất bản. - Logic thử lại: GitHub khuyên nên chờ số giây trong
retry-afterkhi có mặt, và tăng thời gian chờ theo cấp số nhân nếu các yêu cầu tiếp tục thất bại.
Ai tôn trọng Retry-After
- Hỗ trợ khác nhau: MDN lưu ý rằng hỗ trợ của khách hàng và máy chủ cho Retry-After vẫn không đồng nhất.
- Trình thu thập tìm kiếm: Một số trình thu thập, chẳng hạn như Googlebot, tôn trọng nó. Google cho biết một trang web có thể gửi Retry-After với phản hồi 503 hoặc 429 để cho trình thu thập của nó biết khi nào nên thử lại.
- Giữ cho ngắn gọn: Google khuyên không nên phục vụ 500, 503 hoặc 429 để làm chậm việc thu thập dữ liệu trong hơn 1-2 ngày. Nếu Googlebot thấy các mã này trên cùng một URL trong vài ngày, nó có thể loại bỏ URL đó khỏi chỉ mục của mình.