Giới hạn và kích thước

Để nền tảng duy trì ổn định, API có giới hạn về tần suất yêu cầu và kích thước dữ liệu truyền đi.

Tần suất yêu cầu

Khi vượt quá tần suất yêu cầu cho phép, máy chủ phản hồi với mã 429 Too Many Requests. Phản ứng đúng — thử lại với độ trễ tăng dần theo cấp số nhân (backoff): tăng khoảng dừng giữa các lần thử và đừng gửi yêu cầu theo dòng dày đặc. Hãy phân tán các thao tác hàng loạt theo thời gian và tái sử dụng một token theo thứ tự, không phải theo từng đợt song song.

Kích thước nội dung yêu cầu

Đối với các yêu cầu REST thông thường, kích thước nội dung JSON được giới hạn ở 2 MiB. Điều này đủ cho bất kỳ cấu hình phản ứng, bộ sưu tập và cài đặt nào. Nếu nội dung lớn hơn — hãy chia thao tác thành nhiều phần (ví dụ: import phản ứng theo lô).

Kích thước nội dung khi import

Các endpoint import được thiết kế cho các bundle lớn và có giới hạn riêng cao hơn: đến 64 MiB để import dữ liệu và đến 256 MiB để import với media đính kèm. Nếu bundle lớn hơn — hãy chia thành nhiều lần import.

Vượt quá giới hạn

  • Vượt quá giới hạn tần suất — 429, thử lại với độ trễ.
  • Nội dung lớn hơn cho phép — yêu cầu bị từ chối (413 hoặc 400 tùy thuộc vào endpoint); hãy giảm hoặc chia tải trọng.

Tiếp theo