Limity i rozmiary

Aby platforma pozostawała stabilna, API posiada ograniczenia dotyczące częstotliwości zapytań oraz rozmiaru przesyłanych danych.

Częstotliwość zapytań

Gdy dopuszczalna częstotliwość zapytań zostanie przekroczona, serwer odpowiada kodem 429 Too Many Requests. Właściwa reakcja to ponowienie z wykładniczym opóźnieniem (backoff): wydłużaj przerwy między ponowieniami i nie wysyłaj zapytań w gęstym strumieniu. Rozłóż operacje masowe w czasie i używaj jednego tokenu sekwencyjnie, a nie w równoległych seriach.

Rozmiar ciała żądania

Dla zwykłych żądań REST rozmiar ciała JSON jest ograniczony do 2 MiB. Jest to wystarczające dla wszelkich konfiguracji reakcji, kolekcji i ustawień. Jeśli ciało jest większe — podziel operację na części (np. importuj reakcje partiami).

Rozmiar ciała przy imporcie

Endpointy importu są przeznaczone do dużych paczek i mają osobne, wyższe limity: do 64 MiB dla importu danych i do 256 MiB dla importu z osadzonym medium. Jeśli paczka jest większa — podziel ją na kilka importów.

Przekroczenie limitów

  • Przekroczono limit częstotliwości — 429, ponowienie z opóźnieniem.
  • Ciało przekracza dozwolony rozmiar — żądanie jest odrzucane (413 lub 400 w zależności od endpointu); zmniejsz lub podziel ładunek.

Co dalej