Header Retry-After adalah header respons HTTP yang memberi tahu klien berapa lama harus menunggu sebelum melakukan permintaan lanjutan. Server dapat menyertakannya dalam respons 429 Too Many Requests, kode status untuk pembatasan laju. Bagi seorang scraper, menghormati nilai ini berarti berhenti selama yang diminta server, alih-alih menebak dan berisiko lebih banyak permintaan yang diblokir.

Header ini bersifat opsional, jadi respons 429 mungkin datang tanpa itu. RFC 6585 juga tidak mendefinisikan bagaimana server mengidentifikasi pengguna atau menghitung permintaan. Sebuah batas mungkin terkait dengan kredensial login atau cookie, tidak hanya pada alamat IP.

Format Nilai Retry-After

  • Penundaan dalam detik: Sebuah angka bulat non-negatif, seperti Retry-After: 120.
  • Tanggal HTTP: Sebuah tanggal setelahnya untuk mencoba kembali, seperti Retry-After: Wed, 21 Oct 2015 07:28:00 GMT.
  • Di mana ia muncul: Dengan respons 429, dengan 503 Service Unavailable untuk menunjukkan berapa lama gangguan harus berlangsung, dan dengan pengalihan seperti 301 untuk menetapkan waktu tunggu minimum.

Header Pembatasan Lainnya

  • Header vendor: Beberapa API menambahkan bidang mereka sendiri. API REST GitHub, misalnya, mengirimkan x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-used dan x-ratelimit-reset.
  • Standar yang diusulkan: Sebuah Draf Internet IETF mendefinisikan bidang RateLimit dan RateLimit-Policy sehingga server dapat mengiklankan kebijakan kuota dan kuota yang tersisa. Ini masih merupakan draf, bukan RFC yang diterbitkan.
  • Logika ulang: GitHub menyarankan untuk menunggu jumlah detik dalam retry-after ketika ada, dan meningkatkan waktu tunggu secara eksponensial jika permintaan terus gagal.

Siapa yang Menghormati Retry-After

  • Dukungan bervariasi: MDN mencatat bahwa dukungan klien dan server untuk Retry-After masih tidak konsisten.
  • Crawler pencarian: Beberapa crawler, seperti Googlebot, menghormatinya. Google mengatakan sebuah situs dapat mengirim Retry-After dengan respons 503 atau 429 untuk memberi tahu crawler kapan harus mencoba kembali.
  • Jaga tetap singkat: Google menyarankan untuk tidak menyajikan 500, 503 atau 429 untuk memperlambat crawling lebih dari 1-2 hari. Jika Googlebot melihat kode-kode ini pada URL yang sama selama beberapa hari, ia mungkin menghapus URL tersebut dari indeksnya.

Istilah Terkait