Mga Limitasyon sa Rate

Upang matiyak ang mataas na pagganap at pagiging maaasahan para sa lahat ng mga user, inilalapat ng SMSBAT ang paglilimita sa rate sa mga kahilingan sa API. Tinutukoy ng mga limitasyon sa rate ang maximum na bilang ng mga tawag sa API na maaari mong gawin sa loob ng isang takdang panahon.

Mga Default na Limitasyon

Maliban kung iba ang tinukoy sa iyong kontrata, ang mga default na limitasyon sa rate ay inilalapat sa lahat ng mga endpoint ng API (SMSBAT API, Cascade API, at ChatHub API).

Kategorya ng API	Default na Limitasyon	Burst Limit
Mga Endpoint sa Pagmemensahe (/bat/messagelist)	100 kahilingan / segundo	150 kahilingan / segundo
Mga Endpoint ng Data (Katayuan, Balanse, Impormasyon)	50 kahilingan / segundo	75 kahilingan / segundo

[!TANDAAN] Para sa papalabas na pagmemensahe (hal., POST /bat/messagelist), ang isang kahilingan sa HTTP ay maaaring maglaman ng hanggang 5,000 mensahe sa hanay ng mensahe. Nalalapat ang limitasyon sa rate sa bilang ng mga kahilingan sa HTTP, hindi sa bilang ng mga mensaheng ipinadala.

Mga Limitasyon sa Rate ng Pangangasiwa

Kung lalampas ka sa pinapayagang limitasyon sa rate, tutugon ang API gamit ang isang HTTP 429 Too Many Requests status code.

Halimbawa ng Tugon

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

Pinakamahuhusay na Kasanayan

Upang maiwasan ang pagiging limitado sa rate, isaalang-alang ang mga sumusunod na pinakamahuhusay na kagawian:

1. Batch Your Messages: Sa halip na magpadala ng 1,000 hiwalay na HTTP request para sa 1,000 SMS message, magpadala ng isang kahilingan na naglalaman ng array ng 1,000 object.
2. Implement Exponential Backoff: Kung nakatanggap ka ng 429 status code, maghintay ng maikling panahon (hal., 1 segundo), at subukang muli. Kung mabigo muli, doblehin ang oras ng paghihintay (2s, 4s, 8s, atbp.).
3. Pace Your Requests: Kung nagpapatakbo ka ng automated script na nagti-trigger ng libu-libong API call, magpakilala ng kaunting pagkaantala (hal., sleep(10) millisecond) sa pagitan ng mga kahilingan.

Humihiling ng Pagtaas ng Limitasyon

Kung ang iyong kaso ng paggamit ay nangangailangan ng mas mataas na throughput kaysa sa mga default na limitasyon, maaari kang humiling ng pagtaas.

1. Makipag-ugnayan sa iyong nakalaang account manager o mag-email sa [email protected].
2. Ibigay ang iyong Account ID at ang inaasahang throughput (hal., 500 kahilingan kada segundo).
3. Maikling ilarawan ang iyong use case.

Susuriin ng aming technical team ang iyong kahilingan at isasaayos ang iyong mga limitasyon nang naaayon.