रेट लिमिट्स

रेट लिमिट्स यह निर्धारित करती हैं कि आप किसी निश्चित समयावधि में कितने API अनुरोध कर सकते हैं। ये पूरे प्लेटफ़ॉर्म पर निष्पक्ष उपयोग और सिस्टम की स्थिरता सुनिश्चित करती हैं।

उत्पाद के अनुसार रेट लिमिट्स

हर X API उत्पाद के लिए रेट लिमिटिंग का अपना तरीका होता है:

X API v2

15-मिनट की विंडो पर आधारित, प्रति-एंडपॉइंट लिमिट्स। विस्तृत तालिकाएँ और रिकवरी टिप्स देखें।

Enterprise API

आपके एंटरप्राइज़ समझौते और डेटा पैकेज के आधार पर कस्टम लिमिट्स।

X Ads API

विज्ञापन प्रबंधन और एनालिटिक्स एंडपॉइंट्स के लिए विशेष लिमिट्स।

रेट लिमिट्स कैसे काम करती हैं

अवधारणा	विवरण
समय विंडो	अधिकांश लिमिट्स हर 15 मिनट में रीसेट हो जाती हैं
प्रति-उपयोगकर्ता लिमिट्स	OAuth 1.0a या OAuth 2.0 यूज़र टोकन का उपयोग करने पर लागू होती हैं
प्रति-ऐप लिमिट्स	बेयरर टोकन (केवल-ऐप) प्रमाणीकरण का उपयोग करने पर लागू होती हैं
एंडपॉइंट-विशिष्ट	हर एंडपॉइंट की अपनी लिमिट होती है

अपनी रेट लिमिट जाँचें

हर API रिस्पॉन्स में ऐसे हेडर होते हैं, जो आपकी मौजूदा रेट लिमिट स्थिति दिखाते हैं:

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

हेडर	विवरण
`x-rate-limit-limit`	वर्तमान विंडो में अनुमत अनुरोधों की अधिकतम संख्या
`x-rate-limit-remaining`	वर्तमान विंडो में बचे हुए अनुरोध
`x-rate-limit-reset`	सीमा रीसेट होने का Unix timestamp

रेट लिमिट त्रुटियाँ

जब आप रेट लिमिट पार कर जाते हैं, तो आपको 429 Too Many Requests रिस्पॉन्स मिलेगा:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

सर्वोत्तम प्रक्रियाएँ

रिस्पॉन्स कैश करें

एक ही डेटा के लिए बार-बार अनुरोध कम करने हेतु API रिस्पॉन्स को लोकल रूप से संग्रहीत करें।

घातीय बैकऑफ़ का उपयोग करें

रेट लिमिट लागू होने पर, फिर से प्रयास करने से पहले प्रतीक्षा करें। हर पुनः प्रयास के साथ प्रतीक्षा समय दोगुना करें।

हेडर जाँचें

सीमा तक पहुँचने से बचने के लिए रेट लिमिट हेडर की निगरानी करें।

स्ट्रीमिंग का उपयोग करें

रीयल-टाइम डेटा के लिए, search endpoints को poll करने के बजाय filtered stream का उपयोग करें।

अगले चरण

एंडपॉइंट के अनुसार विस्तृत रेट लिमिट्स तालिकाएँ देखने के लिए, अपने संबंधित API का रेट लिमिट्स पेज देखें:

शुरुआत

बुनियादी बातें

भागीदार और ग्राहक

संसाधन