Tarieflimieten en fouten

Snelheidslimieten

Limieten gelden per API-sleutel (of per OAuth-client) per minuut. Als u de limiet overschrijdt, wordt 429 Too Many Requests geretourneerd.

Heb je hogere limieten nodig voor je integratie? Neem contact op met ons team.

Voor gelijktijdige open live-sessies geldt een aparte limiet, geen limiet voor het aantal verzoeken: Free 1 kamer, Pro 1 per presentatorlicentie, Premium 2. Als u hierop drukt, wordt 403 geretourneerd met code session_limit. Beëindig een kamer vanaf Studio (of POST /api/v1/sessions/{id}/control met end) voordat je een andere opent.

Kopteksten snelheidslimiet

JSON-antwoorden bevatten headers met metagegevens met snelheidslimiet:

X-RateLimit-Limit: 120
X-RateLimit-Window: 60s

Als u de limiet overschrijdt, wordt 429 geretourneerd met de foutcode rate_limited. Wacht even voordat u het opnieuw probeert. Er is geen Retry-After-header.

Formaat foutreactie

Alle API-fouten retourneren een JSON-body met een genest error-object dat een door een machine leesbare code en een door mensen leesbare message bevat:

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "error": {
    "code": "not_found",
    "message": "Poll not found."
  }
}

Validatiefouten retourneren 422 met een details-veld in het foutobject:

{
  "error": {
    "code": "validation_failed",
    "message": "Request validation failed.",
    "details": {
      "fieldErrors": { "title": ["String must contain at least 1 character(s)"] },
      "formErrors": []
    }
  }
}

OAuth-tokenfouten volgen in plaats daarvan de indeling RFC 6749 §5.2:

{
  "error": "invalid_client",
  "error_description": "Invalid client credentials."
}

Foutcodes

Nieuwe pogingen en uitstel

We raden een exponentiële back-off met jitter-strategie aan voor productie-integraties:

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

    if (res.status === 429) {
      // PollsLive does not send Retry-After, so back off exponentially
      // (capped at one minute, the length of a rate-limit window).
      const backoff = Math.min(1000 * 2 ** attempt + Math.random() * 500, 60000);
      await new Promise((r) => setTimeout(r, backoff));
      continue;
    }
    if (res.status >= 500 && attempt < maxRetries) {
      const backoff = Math.min(1000 * 2 ** attempt + Math.random() * 500, 30000);
      await new Promise((r) => setTimeout(r, backoff));
      continue;
    }
    return res;
  }
  throw new Error("Max retries exceeded");
}

Probeer niet opnieuw bij 4xx-fouten (anders dan 429): deze duiden op een probleem met je verzoek dat niet wordt opgelost door het opnieuw te proberen.

OAuth foutformaat

Het tokeneindpunt (POST /api/oauth/token) retourneert fouten in RFC 6749-indeling: