Batas frekuensi dan ukuran
Cara menangani permintaan yang terlalu sering atau data yang terlalu besar, termasuk respons 429 dan 413.
Di halaman ini
Jika aplikasi Anda mengirim terlalu banyak permintaan dalam waktu singkat, server dapat meminta aplikasi menunggu. Jika data yang dikirim dalam satu permintaan terlalu besar, server akan menolaknya. Berikut cara menangani kedua keadaan tersebut. Batas untuk pembuat bot dijelaskan di Batas platform.
Frekuensi permintaan
Respons 429 Too Many Requests berarti permintaan dikirim terlalu sering. Tunggu sebelum mencoba lagi. Jika masih ditolak, tambah waktu tunggu, misalnya dari 1 detik menjadi 2 detik, lalu 4 detik. Cara ini disebut penundaan yang bertambah (backoff). Untuk pekerjaan dalam jumlah besar, kirim permintaan secara bertahap, bukan semuanya sekaligus.
Ukuran data dalam permintaan
Untuk permintaan REST biasa, ukuran data JSON dibatasi 2 MiB. Jika lebih besar, bagi pekerjaan menjadi beberapa permintaan, misalnya impor reaksi dalam beberapa kelompok.
Ukuran data saat impor
Impor memiliki batas tersendiri: hingga 64 MiB untuk arsip reaksi beserta berkasnya, dan hingga 256 MiB untuk arsip riwayat percakapan beserta lampirannya. Ukuran arsip yang diunggah dan jumlah seluruh data setelah arsip dibuka harus memenuhi batas masing-masing. Jika lebih besar, bagi data menjadi beberapa impor.
Jika batas terlampaui
- Permintaan terlalu sering: server mengirim
429. Tunggu, lalu coba lagi. - Data terlalu besar: server menolak permintaan dengan
413atau400, tergantung jenisnya. Kurangi data atau bagi menjadi beberapa permintaan.
Langkah berikutnya
- Kesalahan API: arti
429dan respons lainnya. - Impor dari sambot: cara memindahkan arsip berukuran besar.
- Referensi API: batas untuk setiap permintaan.