Limity żądań

Aby platforma była szybka i niezawodna dla wszystkich, REST API SIP Caller ogranicza liczbę żądań, które może wysłać każdy klucz API.

Limity

Każdy klucz API może wysłać średnio do 20 żądań na sekundę.

Limit dotyczy każdego klucza API osobno. Do limitu wliczają się wszystkie żądania, w tym te, które zakończyły się błędem.

Wnioskowanie o wyższy limit

Jeśli Twoja integracja potrzebuje wyższego limitu, skontaktuj się z nami i opisz swój przypadek użycia: co robi Twoja integracja, ile żądań wysyła i jak są one rozłożone w czasie. Przeanalizujemy go i pomożemy Ci znaleźć najlepsze rozwiązanie, które może obejmować zwiększenie limitu dla Twojego konta.

Przekroczenie limitu

Po przekroczeniu limitu API zwraca błąd 429 Too Many Requests z nagłówkiem Retry-After, wskazującym liczbę sekund, jaką należy odczekać przed wysłaniem kolejnych żądań:

HTTP/1.1 429 Too Many Requests
Retry-After: 5

{
  "type": "https://tools.ietf.org/html/rfc6585#section-4",
  "title": "One or more errors occurred.",
  "status": 429,
  "detail": "Too many requests. Retry after 5 seconds.",
  "instance": "/v1/accounts/ACCOUNT_ID/campaigns",
  "traceId": "0HN6QKQ1B2F3G:00000004"
}

Dobre praktyki

• Respektuj nagłówek Retry-After. Gdy otrzymasz błąd 429, odczekaj co najmniej wskazaną liczbę sekund przed ponowieniem żądania.
• Używaj endpointów zbiorczych. Większość operacji akceptuje wiele rekordów w jednym żądaniu. Na przykład dodaj setki numerów do kampanii w jednym żądaniu Dodawanie numerów, zamiast wysyłać jedno żądanie na numer, lub prześlij plik CSV.
• Używaj webhooków zamiast odpytywania. Zamiast sprawdzać zmiany co kilka sekund, zasubskrybuj webhooki, aby otrzymywać powiadomienia, gdy kampanie zmieniają stan lub kończą się połączenia.
• Używaj większych stron. Podczas odczytywania długich list żądaj stron po kilkaset rekordów zamiast małych stron. Zobacz Paginacja.
• Rozkładaj zadania wsadowe w czasie. Jeśli zadanie wysyła wiele żądań, dodaj między nimi krótkie opóźnienie, zamiast wysyłać je wszystkie naraz.