Mokapen API dokumentace

Limity API

Mokapen uplatňuje dvě úrovně limitů: omezení za minutu a denní kvótu na základě plánu vaší organizace.

Patro Typ Denní limit
Free Uvolnit 200
Small Team Za poplatek 2,000
Medium Za poplatek 8,000
Large Za poplatek 20,000

Limit za minutu

Standardní API klienti jsou omezeni na 60 požadavků za minutu na klienta nebo ověřeného uživatele.

Mobilní klienti s hlavičkou X-Client: mobilní může mít vyšší limit (200 požadavků za minutu).

HTTP/1.1 429 Příliš mnoho požadavků

{
  "stav": nepravda,
  "message": "Příliš mnoho požadavků",
  "max_attempts": 60,
  "zbývající": 0,
  "retry_after": "45 sekund"
}

Denní poplatek (za plán)

Každá organizace má denní kvótu žádostí API určenou plánem Mokapen. Poplatek se vztahuje na organizaci za kalendářní den (UTC).

Pokud je denní kvóta překročena, API odpoví 429 Too Many Requests zprávou o překročení kvóty.

HTTP/1.1 429 Příliš mnoho požadavků

{
  "message": "Kvóta překročena",
  "Denní limit požadavků API překročen.\n": 2000
}

Osvědčené postupy

  • Pokud je to možné, ukládejte odpovědi do mezipaměti namísto častého dotazování.
  • Implementujte exponenciální ústup v případě 429 odpovědí.
  • Místo opakovaného dotazování používejte webhooky pro integrace řízené událostmi.
  • Požadujte pouze nezbytné rozsahy.

Potřebujete pomoc?