Limity volání

Limity volání chrání API před přetížením a udržují stabilní provoz pro všechny klienty.

Jak se projeví limit

Při překročení limitu API vrátí HTTP 429 Too Many Requests s hlavičkou Retry-After a tělem odpovědi:

HTTP/1.1 429 Too Many Requests
Retry-After: 10

{
  "Code": "RATE_LIMIT_EXCEEDED",
  "Message": "Too many requests. Please try again later.",
  "RetryAfterSeconds": 10
}

Pole RetryAfterSeconds obsahuje, kolik sekund máte počkat před dalším pokusem. Stejná hodnota je i v hlavičce Retry-After.

Jak se zachovat při projevení limitu

1. Neopakujte požadavek okamžitě.
2. Vyčkejte počet sekund z RetryAfterSeconds (nebo Retry-After hlavičky).

Specifické omezení volání endpointu pro status exportu

Endpoint GET /api/v1/ExportResult/Status/{idExportJob} má přísnější samostatný limit napříč všemi tarify:

• max 10 volání za 60 sekund na API klíč,
• při překročení API vrací 429 Too Many Requests (RATE_LIMIT_EXCEEDED, Retry-After, RetryAfterSeconds).

Praktické doporučení

• Omezte paralelismus na straně klienta, posílejte požadavky postupně, ne najednou.
• Pro exporty používejte callback URL nebo e-mail notifikaci místo častého dotazování se na stav.