Limity zapytań

API SentiSnap stosuje limity zapytań w celu zapewnienia uczciwego korzystania i stabilności platformy.

Limity według planu

Nagłówki limitów zapytań

Każda odpowiedź zawiera nagłówki z aktualnym stanem Twojego limitu zapytań:

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

Obsługa limitów zapytań

Po przekroczeniu limitu zapytań otrzymasz odpowiedź 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
    }
  }
}

Nagłówek Retry-After wskazuje, ile sekund należy odczekać przed ponowną próbą.

Zalecane praktyki

• Cachuj odpowiedzi — przechowuj dane lokalnie, aby zmniejszyć liczbę wywołań API
• Używaj webhooków — otrzymuj aktualizacje w czasie rzeczywistym zamiast odpytywania
• Zaimplementuj exponential backoff — czekaj dłużej między próbami po niepowodzeniach
• Grupuj żądania — efektywnie korzystaj z paginacji, pobieraj tylko to, czego potrzebujesz
• Monitoruj wykorzystanie — śledź nagłówek X-RateLimit-Remaining

Przykład: 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');
}

Potrzebujesz wyższych limitów?

Skontaktuj się z naszym zespołem sprzedaży pod adresem [email protected], aby omówić plany enterprise z wyższymi limitami zapytań.