दर सीमाएं और त्रुटियां

दर सीमाएं

सीमाएं प्रति API कुंजी (या प्रति OAuth क्लाइंट) प्रति मिनट लागू होती हैं। सीमा पार करने पर 429 Too Many Requests मिलता है।

अपने इंटीग्रेशन के लिए अधिक सीमाएँ चाहिए? हमारी टीम से संपर्क करें।

एक साथ खुली लाइव सेशन एक अलग सीमा है, अनुरोध-दर सीमा नहीं: Free 1 कक्ष, Pro प्रति प्रस्तुतकर्ता लाइसेंस 1, Premium 2। सीमा पर पहुंचने पर session_limit कोड के साथ 403 मिलता है। दूसरा खोलने से पहले Studio से (या end के साथ POST /api/v1/sessions/{id}/control से) कोई कक्ष समाप्त करें।

दर सीमा हेडर

JSON प्रतिक्रियाओं में दर-सीमा मेटाडेटा हेडर होते हैं:

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

सीमा पार करने पर rate_limited कोड के साथ 429 मिलता है। पुनःप्रयास से पहले रुकें। कोई Retry-After हेडर नहीं है।

त्रुटि प्रतिक्रिया प्रारूप

सभी API त्रुटियां एक JSON बॉडी लौटाती हैं जिसमें नेस्टेड error ऑब्जेक्ट होता है, जिसमें मशीन-पठनीय code और मानव-पठनीय message होते हैं:

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

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

सत्यापन त्रुटियां त्रुटि ऑब्जेक्ट के भीतर details फ़ील्ड के साथ 422 लौटाती हैं:

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

OAuth टोकन त्रुटियां इसके बजाय RFC 6749 §5.2 प्रारूप का पालन करती हैं:

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

त्रुटि कोड

पुनःप्रयास और प्रतीक्षा

उत्पादन एकीकरणों के लिए हम जिटर के साथ घातीय प्रतीक्षा रणनीति की सलाह देते हैं:

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");
}

4xx त्रुटियों (429 को छोड़कर) पर पुनःप्रयास न करें: ये आपके अनुरोध में ऐसी समस्या बताती हैं जो दोहराने से हल नहीं होगी।

OAuth त्रुटि प्रारूप

टोकन एंडपॉइंट (POST /api/oauth/token) RFC 6749 प्रारूप में त्रुटियां लौटाता है: