Przejdź do treści

Limity stawek

Aby zapewnić wysoką wydajność i niezawodność wszystkim użytkownikom, SMSBAT stosuje ograniczenie szybkości żądań API. Limity szybkości określają maksymalną liczbę wywołań API, jakie możesz wykonać w danym przedziale czasowym.

Domyślne limity

O ile w umowie nie określono inaczej, domyślne limity szybkości obowiązują we wszystkich punktach końcowych API (SMSBAT API, Cascade API i ChatHub API).

Kategoria API Limit domyślny Limit wybuchu
Punkty końcowe przesyłania wiadomości (/bat/messagelist) 100 żądań / sekundę 150 żądań / sekundę
Punkty końcowe danych (stan, saldo, informacje) 50 żądań / sekundę 75 żądań / sekundę

[!UWAGA] W przypadku wiadomości wychodzących (np. POST /bat/messagelist) jedno żądanie HTTP może zawierać do 5000 wiadomości w tablicy messages. Limit szybkości dotyczy liczby żądań HTTP, a nie liczby wysłanych wiadomości.

Limity szybkości obsługi

Jeśli przekroczysz dozwolony limit szybkości, interfejs API odpowie kodem stanu HTTP „429 Too Many Requests”.

Przykład odpowiedzi

KOD_BLOKU_0

Najlepsze praktyki

Aby uniknąć ograniczeń stawek, rozważ następujące najlepsze praktyki:

  1. Zgrupuj swoje wiadomości: Zamiast wysyłać 1000 oddzielnych żądań HTTP na 1000 wiadomości SMS, wyślij pojedyncze żądanie zawierające tablicę 1000 obiektów.
  2. Wdrożenie wykładniczego wycofywania: Jeśli otrzymasz kod statusu „429”, odczekaj krótki okres (np. 1 sekundę) i spróbuj ponownie. Jeśli ponownie się nie powiedzie, podwój czas oczekiwania (2 s, 4 s, 8 s itd.).
  3. Trzymaj tempo swoich żądań: Jeśli używasz automatycznego skryptu, który uruchamia tysiące wywołań API, wprowadź małe opóźnienie (np. sleep(10) milisekundy) pomiędzy żądaniami.

Prośba o zwiększenie limitu

Jeśli Twój przypadek użycia wymaga wyższej przepustowości niż limity domyślne, możesz poprosić o zwiększenie.

  1. Skontaktuj się ze swoim opiekunem konta lub wyślij e-mail na adres [email protected].
  2. Podaj swój identyfikator konta i oczekiwaną przepustowość (np. 500 żądań na sekundę).
  3. Krótko opisz swój przypadek użycia.

Nasz zespół techniczny rozpatrzy Twoją prośbę i odpowiednio dostosuje Twoje limity.