Limiti tar-Rata
Biex tiżgura prestazzjoni għolja u affidabbiltà għall-utenti kollha, SMSBAT tapplika tillimita tar-rata għat-talbiet tal-API. Il-limiti tar-rata jispeċifikaw in-numru massimu ta' sejħiet API li tista' tagħmel f'perjodu ta' żmien partikolari.
Limiti Default
Sakemm ma jkunx speċifikat mod ieħor fil-kuntratt tiegħek, il-limiti tar-rata awtomatika huma applikati fl-endpoints kollha tal-API (SMSBAT API, Cascade API, u ChatHub API).
| Kategorija API | Limitu Default | Limitu tat-tifqigħ |
|---|---|---|
Messaging Endpoints (/bat/messagelist) |
100 talba / sekonda | 150 talba / sekonda |
| Endpoints tad-Data (Status, Bilanċ, Informazzjoni) | 50 talba / sekonda | 75 talba / sekonda |
[!NOTA] Għal messaġġi 'l barra (eż.,
POST /bat/messagelist), talba HTTP waħda jista' jkun fiha sa 5,000 messaġġ fil-firxa ta'messaġġi. Il-limitu tar-rata japplika għan-numru ta' talbiet HTTP, mhux għan-numru ta' messaġġi mibgħuta.
Limiti tar-Rata tal-Immaniġġjar
Jekk taqbeż il-limitu tar-rata permessa, l-API tirrispondi b'kodiċi tal-istatus HTTP "429 Too Many Requests".
Eżempju ta’ Rispons
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please wait before sending more requests.",
"status": 429
}
L-Aħjar Prattiki
Biex tevita li tkun limitata bir-rata, ikkunsidra l-aħjar prattiki li ġejjin:
- Lott Messaġġi Tiegħek: Minflok ma tibgħat 1,000 talba HTTP separata għal 1,000 messaġġ SMS, ibgħat talba waħda li jkun fiha firxa ta '1,000 oġġett.
- Implimenta Backoff Esponenzjali: Jekk tirċievi kodiċi tal-istatus
429, stenna għal perjodu qasir (eż., sekonda), u erġa' pprova. Jekk jerġa’ jfalli, idduppja l-ħin ta’ stennija (2s, 4s, 8s, eċċ.). - Pace Your Requests: Jekk qed tħaddem skript awtomatizzat li jqanqal eluf ta' sejħiet API, daħħal dewmien żgħir (eż.,
sleep(10)millisekondi) bejn it-talbiet.
Talba għal Żieda fil-Limitu
Jekk il-każ tal-użu tiegħek jeħtieġ throughput ogħla mil-limiti default, tista' titlob żieda.
- Ikkuntattja lill-maniġer tal-kont iddedikat tiegħek jew ibgħat email [email protected].
- Ipprovdi l-ID tal-Kont tiegħek u l-fluss mistenni (eż., 500 talba kull sekonda).
- Iddeskrivi fil-qosor il-każ tal-użu tiegħek.
It-tim tekniku tagħna se jirrevedi t-talba tiegħek u jaġġusta l-limiti tiegħek kif xieraq.