Rate limity

Sentisnap API implementuje rate limiting pro zajištění férového využívání a stability platformy.

Limity podle plánu

Hlavičky rate limitů

Každá odpověď obsahuje hlavičky s aktuálním stavem vašeho rate limitu:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1704891600
X-RateLimit-Policy: 1000;w=3600

Zpracování rate limitů

Když překročíte rate limit, obdržíte odpověď 429 Too Many Requests:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please slow down your requests.",
    "details": {
      "limit": 1000,
      "remaining": 0,
      "reset": 1704891600,
      "retry_after": 3600
    }
  }
}

Hlavička Retry-After udává, kolik sekund čekat před dalším pokusem.

Doporučené postupy

• Cachujte odpovědi — ukládejte data lokálně pro snížení API volání
• Používejte webhooky — dostávejte aktualizace v reálném čase místo pollingu
• Implementujte exponential backoff — čekejte déle mezi pokusy po selhání
• Dávkujte požadavky — používejte paginaci efektivně, vyžádejte si jen to, co potřebujete
• Monitorujte využití — sledujte hlavičku X-RateLimit-Remaining

Příklad: Exponential Backoff

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || Math.pow(2, i);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }

    return response;
  }
  throw new Error('Max retries exceeded');
}

Potřebujete vyšší limity?

Kontaktujte náš obchodní tým na [email protected] pro diskuzi o enterprise plánech s vyššími rate limity.