Likmes ierobežojumi

Lai nodrošinātu augstu veiktspēju un uzticamību visiem lietotājiem, SMSBAT API pieprasījumiem piemēro ātruma ierobežojumu. Likmes ierobežojumi norāda maksimālo API zvanu skaitu, ko varat veikt noteiktā laika posmā.

Noklusējuma ierobežojumi

Ja vien līgumā nav norādīts citādi, visiem API galapunktiem (SMSBAT API, Cascade API un ChatHub API) tiek piemēroti noklusējuma ātruma ierobežojumi.

API kategorija	Noklusējuma ierobežojums	Burst Limit
Ziņojumapmaiņas galapunkti (`/bat/messagelist`)	100 pieprasījumi sekundē	150 pieprasījumi sekundē
Datu galapunkti (statuss, atlikums, informācija)	50 pieprasījumi sekundē	75 pieprasījumi sekundē

[!PIEZĪME] Izejošajai ziņojumapmaiņai (piem., POST /bat/messagelist) vienā HTTP pieprasījumā masīvā "Ziņojumi" var būt līdz 5000 ziņojumiem. Ātruma ierobežojums attiecas uz HTTP pieprasījumu skaitu, nevis nosūtīto ziņojumu skaitu.

Apstrādes ātruma ierobežojumi

Ja pārsniegsiet atļauto ātruma ierobežojumu, API atbildēs ar HTTP statusa kodu “429 pārāk daudz pieprasījumu”.

Atbildes piemērs

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Labākā prakse

Lai izvairītos no likmes ierobežojuma, ņemiet vērā tālāk norādīto paraugpraksi.

1. Sakārtojiet ziņojumus: tā vietā, lai nosūtītu 1000 atsevišķus HTTP pieprasījumus 1000 īsziņām, nosūtiet vienu pieprasījumu, kurā ir 1000 objektu masīvs. 2. Ieviesiet eksponenciālo atkāpšanos: ja saņemat statusa kodu “429”, uzgaidiet īsu laiku (piemēram, 1 sekundi) un mēģiniet vēlreiz. Ja tas atkal neizdodas, dubultojiet gaidīšanas laiku (2s, 4s, 8s utt.). 3. Paātriniet pieprasījumu izpildi: ja izmantojat automatizētu skriptu, kas aktivizē tūkstošiem API izsaukumu, starp pieprasījumiem ieviesiet nelielu aizkavi (piemēram, miega (10) milisekundes).

Limita palielināšanas pieprasīšana

Ja jūsu lietošanas gadījumā ir nepieciešama lielāka caurlaidspēja nekā noklusējuma ierobežojumi, varat pieprasīt palielinājumu.

1. Sazinieties ar savu īpašo konta pārzini vai rakstiet uz e-pasta adresi [email protected]. 2. Norādiet sava konta ID un paredzamo caurlaidspēju (piemēram, 500 pieprasījumu sekundē). 3. Īsi aprakstiet savu lietošanas gadījumu.

Mūsu tehniskā komanda izskatīs jūsu pieprasījumu un attiecīgi pielāgos jūsu ierobežojumus.