Zrozumienie limitów zapytań API

Aby zapewnić niezawodność i wydajność naszego API, monday.com stosuje kilka limitów zapytań. Pomagają one zarządzać obciążeniem systemu i zapewniają sprawiedliwe korzystanie z API wszystkim użytkownikom. Przekroczenie limitu może spowodować tymczasowe błędy, ale jeśli wiesz, jak działają limity, możesz uniknąć przerw w działaniu.

Szczegóły techniczne i przykłady znajdziesz w dokumentacji dla deweloperów dotyczącej limitów zapytań.

Rodzaje limitów zapytań

1. Limit złożoności

Określa, jak „ciężkie” jest zapytanie. Większość użytkowników nie przekroczy tego limitu. Jeśli jednak do tego dojdzie, zobaczysz błąd:

• Komunikat błędu: COMPLEXITY_BUDGET_EXHAUSTED

• Co zrobić:

• Pobieraj tylko potrzebne dane

• Unikaj zbyt złożonych zapytań i zapytań z wieloma poziomami zagnieżdżenia
• Jeśli to możliwe, używaj paginacji

2. Dzienny limit wywołań

Każde żądanie API może obejmować wiele wywołań API. Każde konto ma dzienny limit liczby wywołań API:

Plan	Limit dzienny
Free/Trial	200
Basic/Standard	1,000
Pro	10,000
Enterprise	25,000

• Komunikat błędu: DAILY_LIMIT_EXCEEDED

• Co zrobić:

• Zoptymalizuj kod, aby ograniczyć niepotrzebne wywołania

• Poczekaj na odnowienie limitu o północy UTC
• Jeśli jesteś administratorem, możesz też kupić dodatkowy dzienny limit wywołań API w ramach dodatku do wywołań API. Możesz to zrobić w sekcji administracyjnej, kontaktując się z zespołem obsługi Twojego konta lub pomocą techniczną. Każda jednostka zwiększa dzienny limit o 25 000 wywołań API. Możesz kupić kilka jednostek.

3. Limit zapytań na minutę

Ogranicza liczbę zapytań na minutę. Po przekroczeniu limitu:

• Komunikat błędu: Rate Limit Exceeded

• Co zrobić:

• Wysyłaj żądania rzadziej

• Sprawdź nagłówek Retry-After, aby dowiedzieć się, kiedy możesz bezpiecznie ponowić próbę.

4. Limit równoległości

Ogranicza liczbę wywołań API obsługiwanych jednocześnie.

• Komunikat błędu: maxConcurrencyExceeded

• Co zrobić:

• Wysyłaj mniej żądań równolegle

• Dodaj mechanizm ponawiania, który odczeka przed kolejną próbą

5. Limit adresu IP

Ogranicza liczbę żądań z jednego adresu IP w krótkim czasie (5 000 żądań na 10 sekund).

• Komunikat błędu: IP_RATE_LIMIT_EXCEEDED

• Co zrobić:

• Przed ponowieniem żądania odczekaj czas wskazany w polu retry_in_seconds w odpowiedzi błędu

Uwaga: Działania wykonywane za pośrednictwem połączeń MCP zużywają wywołania API.

Ogólne dobre praktyki

• Wszystkie żądania - nawet te zakończone niepowodzeniem - są wliczane do limitów.
• Nie ponawiaj żądania od razu po błędzie limitu. Zawsze sprawdzaj pole retry_in_seconds w odpowiedzi.
• Jeśli korzystasz z naszego SDK, automatycznie uwzględnia ono odpowiedzi o przekroczeniu limitu i ponawia żądania po odpowiednim czasie oczekiwania.

Deweloperom zalecamy zapoznanie się z pełną dokumentacją dotyczącą limitów zapytań, aby dowiedzieć się, jak limity zależą od sposobu korzystania z API i wybranego planu.

Potrzebujesz pomocy w optymalizacji korzystania z API? Skontaktuj się z naszym zespołem pomocy technicznej, aby uzyskać wskazówki.