Przejdź do treści
ShopentlyLearn

Limity zapytań API

Kolejkuj pracę integracji i reaguj na limity obowiązujące dla sklepu.

Limity zapytań API

Engine ≥ 4.143.0. Każda odpowiedź z tokenem zawiera data.rate_limits z polityki sklepu obowiązującej przy jego wydaniu. Wszystkie klucze współdzielą te budżety; nowy token ich nie resetuje. Zmiana planu może obowiązywać przed wygaśnięciem tokenu.

read_per_minute
Zapytania odczytu na minutę.
write_per_minute
Zapytania zapisu na minutę; ta wartość nie nadaje uprawnień do zapisu.
auth_per_minute
Żądania pobrania tokenu na minutę, także nieudane próby uwierzytelnienia.

Rozkładaj żądania równomiernie w czasie; przy dodatnim limicie odczytów stosuj odstęp co najmniej 60 / read_per_minute sekund. Limit nie gwarantuje przyjęcia tylu żądań naraz. Korzystają z niego również inne integracje: obsługuj 429 i Retry-After.

Zero oznacza niedostępność, a nie brak ograniczenia.

Limity na minutę

Limity na minutę
Dostępne od planuOdczyt · GET
BASIC60
STANDARD120
PROFESSIONAL300
ADVANCED900
Zapis
10
Uwierzytelnianie
10

Limity są wspólne dla wszystkich kluczy danego sklepu.

Żądanie

  • Odczyty i zapisy podlegają bieżącej polityce API sklepu.
  • Klucze nie zapewniają oddzielnej, nieograniczonej przepustowości.
  • Ogranicz współbieżność, przechowuj dane słownikowe tam, gdzie jest to właściwe, i unikaj wielokrotnego pobierania niezmienionych szczegółów.

429 · Retry-After

  • Gdy API zwróci 429 z rate_limit.exceeded, odczekaj co najmniej liczbę sekund wskazaną przez Retry-After i dodaj losowe opóźnienie.
  • 429 · capacity.queue_full — Krótka kolejka API jest pełna; żądanie nie rozpoczęło wykonania. 429 · capacity.wait_timeout — Upłynął czas oczekiwania w kolejce API; żądanie nie rozpoczęło wykonania. Odczekaj co najmniej Retry-After sekund i dodaj losowe opóźnienie. Ponawiając zapis, zachowaj oryginalny klucz i treść.
  • Korzystaj z kodu błędu i nagłówka, zamiast zgadywać stały czas ponawiania.