Batas dan ukuran

Agar platform tetap stabil, API memiliki batasan frekuensi permintaan dan ukuran data yang dikirimkan.

Frekuensi permintaan

Jika frekuensi permintaan yang diizinkan terlampaui, server merespons dengan kode 429 Too Many Requests. Respons yang tepat adalah pengulangan dengan penundaan eksponensial (backoff): tingkatkan jeda antar pengulangan dan jangan kirim permintaan secara terus-menerus. Distribusikan operasi massal dalam waktu dan gunakan satu token secara berurutan, bukan dalam lonjakan paralel.

Ukuran body permintaan

Untuk permintaan REST biasa, ukuran body JSON dibatasi 2 MiB. Ini cukup untuk konfigurasi reaksi, koleksi, dan pengaturan apa pun. Jika body lebih besar — pecah operasi menjadi bagian-bagian (misalnya, impor reaksi dalam batch).

Ukuran body saat impor

Endpoint impor dirancang untuk bundle besar dan memiliki batas yang lebih tinggi secara terpisah: hingga 64 MiB untuk impor data dan hingga 256 MiB untuk impor dengan media tertanam. Jika bundle lebih besar — bagi menjadi beberapa impor.

Melebihi batas

  • Batas frekuensi terlampaui — 429, ulangi dengan penundaan.
  • Body melebihi yang diizinkan — permintaan ditolak (413 atau 400 tergantung pada endpoint); kurangi atau pecah payload.

Selanjutnya