Kihagyás

Díjkorlátok

A nagy teljesítmény és a megbízhatóság minden felhasználó számára biztosítása érdekében az SMSBAT sebességkorlátozást alkalmaz az API-kéréseknél. A sebességkorlátok meghatározzák az adott időkereten belül kezdeményezhető API-hívások maximális számát.

Alapértelmezett korlátok

Hacsak a szerződés másként nem rendelkezik, az alapértelmezett sebességkorlátok minden API-végpontra vonatkoznak (SMSBAT API, Cascade API és ChatHub API).

API kategória Alapértelmezett korlát Burst Limit
Üzenetküldési végpontok (/bat/messagelist) 100 kérés/másodperc 150 kérés/másodperc
Adatvégpontok (állapot, egyenleg, információ) 50 kérés/másodperc 75 kérés/másodperc

[!MEGJEGYZÉS] Kimenő üzenetküldéshez (pl. "POST /bat/messagelist") egy HTTP-kérés legfeljebb 5000 üzenetet tartalmazhat az "üzenetek" tömbben. A sebességkorlát a HTTP-kérések számára vonatkozik, nem az elküldött üzenetekre.

Kezelési sebességi korlátok

Ha túllépi a megengedett sebességkorlátot, az API HTTP „429 túl sok kérés” állapotkóddal válaszol.

Válasz példa

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

Bevált gyakorlatok

A díjkorlátozás elkerülése érdekében vegye figyelembe a következő bevált módszereket:

  1. Üzenetek kötegelése: Ahelyett, hogy 1000 különálló HTTP-kérést küldene 1000 SMS-hez, küldjön egyetlen kérést, amely 1000 objektumot tartalmazó tömböt tartalmaz.
  2. Exponenciális visszalépés végrehajtása: Ha „429” állapotkódot kap, várjon egy rövid ideig (pl. 1 másodpercig), majd próbálkozzon újra. Ha ismét meghiúsul, duplázza meg a várakozási időt (2s, 4s, 8s stb.).
  3. A kérések ütemezése: Ha olyan automatizált szkriptet futtat, amely API-hívások ezreit indítja el, vezessen be egy kis késleltetést (pl. sleep(10) ezredmásodperc) a kérések között.

Limit emelés kérése

Ha az Ön használati esete az alapértelmezett határértékeknél nagyobb átviteli sebességet igényel, kérhet növelést.

  1. Lépjen kapcsolatba fiókkezelőjével, vagy írjon e-mailt a [email protected] címre.
  2. Adja meg fiókazonosítóját és a várható átviteli sebességet (pl. 500 kérés másodpercenként).
  3. Röviden írja le a használati esetét.

Technikai csapatunk felülvizsgálja kérését, és ennek megfelelően módosítja a korlátokat.