Kalo te përmbajtja

Kufijtë e tarifave

Për të siguruar performancë të lartë dhe besueshmëri për të gjithë përdoruesit, SMSBAT zbaton kufizimin e tarifave për kërkesat API. Kufijtë e tarifave përcaktojnë numrin maksimal të thirrjeve API që mund të bëni brenda një harku kohor të caktuar.

Kufijtë e paracaktuar

Nëse nuk specifikohet ndryshe në kontratën tuaj, kufijtë e normës së paracaktuar zbatohen në të gjitha pikat fundore të API (SMSBAT API, Cascade API dhe ChatHub API).

Kategoria API Kufiri i parazgjedhur Kufiri i shpërthimit
Pika përfundimtare të mesazheve (/bat/messagelist) 100 kërkesa / sekondë 150 kërkesa / sekondë
**Pika përfundimtare të të dhënave ** (Statusi, Bilanci, Informacioni) 50 kërkesa / sekondë 75 kërkesa / sekondë

[!SHËNIM] Për mesazhet dalëse (p.sh., POST /bat/messagelist), një kërkesë HTTP mund të përmbajë deri në 5000 mesazhe në grupin e "mesazheve". Kufiri i tarifës vlen për numrin e kërkesave HTTP, jo numrin e mesazheve të dërguara.

Kufijtë e normës së trajtimit

Nëse e tejkaloni kufirin e lejuar të tarifës, API do të përgjigjet me një kod statusi HTTP 429 Shumë shumë kërkesa.

Shembull i përgjigjes

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

Praktikat më të mira

Për të shmangur kufizimin e tarifave, merrni parasysh praktikat më të mira të mëposhtme:

  1. Batch Your Messages: Në vend që të dërgoni 1000 kërkesa të veçanta HTTP për 1000 mesazhe SMS, dërgoni një kërkesë të vetme që përmban një grup prej 1000 objektesh.
  2. Zbatoni Backoff Exponential: Nëse merrni një kod statusi 429, prisni për një periudhë të shkurtër (p.sh., 1 sekondë) dhe provoni përsëri. Nëse dështon përsëri, dyfishoni kohën e pritjes (2s, 4s, 8s, etj.).
  3. Ritmi i kërkesave tuaja: Nëse po ekzekutoni një skript të automatizuar që shkakton mijëra thirrje API, futni një vonesë të vogël (p.sh., sleep(10) milisekonda) midis kërkesave.

Duke kërkuar një rritje të limitit

Nëse rasti juaj i përdorimit kërkon një xhiro më të lartë se kufijtë e paracaktuar, mund të kërkoni një rritje.

  1. Kontaktoni menaxherin tuaj të dedikuar të llogarisë ose emailin [email protected].
  2. Jepni ID-në e llogarisë tuaj dhe xhiron e pritshme (p.sh., 500 kërkesa për sekondë).
  3. Përshkruani shkurtimisht rastin tuaj të përdorimit.

Ekipi ynë teknik do të shqyrtojë kërkesën tuaj dhe do të rregullojë kufijtë tuaj në përputhje me rrethanat.