मुख्य सामग्री पर जाएँ
Telm

API rate limits और कोटा — दैनिक और प्रति-मिनट | Telm

दो Telm API सीमाएँ समझें: एक प्रति-मिनट rate limit और प्रति प्लान एक दैनिक कोटा। X-Quota headers पढ़ें और 429 प्रतिक्रियाओं को सही ढंग से संभालें।

5 मिनट पढ़ें
संक्षेप में

Telm API को दो तरह से मीटर करता है: एक प्रति-मिनट rate limit (एक बर्स्ट सीमा) और एक दैनिक कोटा (UTC दिन के लिए आपका कुल बजट)। दोनों प्लान के साथ बढ़ते हैं। हर मीटर की गई प्रतिक्रिया X-Quota-Limit, X-Quota-Used और X-Quota-Reset लौटाती है ताकि आपको हमेशा अपना शेष बजट पता हो, और पार होने पर दोनों सीमाएँ एक Retry-After header के साथ 429 लौटाती हैं।

आपका API प्लान और दैनिक कोटा Developers पेज पर दिखाया जाता है।

1दो सीमाएँ: प्रति-मिनट rate और दैनिक कोटा

दो अलग ऊपरी सीमाएँ हैं। प्रति-मिनट rate limit सीमित करती है कि आप किसी एक मिनट के भीतर कितने अनुरोध कर सकते हैं, बर्स्ट को समतल करते हुए। दैनिक कोटा आपका कुल बजट है: यह सीमित करता है कि आप पूरे UTC दिन में कितनी मीटर की गई कॉल कर सकते हैं।

वे स्वतंत्र हैं। आप प्रति-मिनट सीमा से टकरा सकते हैं जबकि आपके पास ख़ूब दैनिक कोटा बचा हो (आप बस बहुत तेज़ भेज रहे हैं), या अपना दैनिक कोटा ख़त्म कर सकते हैं जबकि आप प्रति-मिनट सीमा से काफ़ी नीचे हों (आपने दिन इस्तेमाल कर लिया)। दोनों 429 स्थिति लौटाते हैं, पर अलग-अलग कारणों से — उन्हें अलग बताने के लिए body में error कोड जाँचें।

  • प्रति-मिनट rate limit — एक बर्स्ट सीमा, हर मिनट रीसेट होती है।
  • दैनिक कोटा — दिन के लिए आपकी कुल मीटर की गई कॉल, मध्यरात्रि UTC पर रीसेट होती है।
  • कोटा प्रति खाता एक बार गिना जाता है, आपकी सभी कुंजियों में साझा।

2प्रति प्लान दैनिक कोटा

आपका दैनिक कोटा वह मीटर की गई API कॉल की संख्या है जो आप प्रति UTC दिन कर सकते हैं, और यह आपके प्लान पर निर्भर करता है। काउंटर आपकी सभी कुंजियों में साझा होता है और आप जिन ग्रुपों को मैनेज करते हैं उनमें सर्वश्रेष्ठ प्लान का अनुसरण करता है — बिना किसी सशुल्क सदस्यता के, आप Free स्तर पर हैं।

यह अवधि UTC कैलेंडर दिन है, इसलिए आपका used काउंटर मध्यरात्रि UTC पर शून्य पर रीसेट हो जाता है। एक batch spam check में batch के हर आइटम के लिए एक कॉल लगती है, न कि पूरे अनुरोध के लिए एक।

  • Free — प्रति दिन 100 कॉल।
  • Basic — प्रति दिन 1,000 कॉल।
  • Pro — प्रति दिन 10,000 कॉल।
  • Business — प्रति दिन 50,000 कॉल।
Free और Basic के लिए केवल एकल spam जाँचें मीटर होती हैं; बाक़ी API (सहित batch spam check) को Pro प्लान या उच्चतर चाहिए।

3प्रति प्लान प्रति-मिनट rate limit

दैनिक कोटा के ऊपर, हर API कुंजी अपने प्लान स्तर के अनुसार प्रति मिनट एक संख्या के अनुरोधों तक सीमित है। यह एक समतलन सीमा है: यह किसी एक क्लाइंट को एक सेकंड में एक विशाल स्पाइक भेजने से रोकती है, तब भी जब दैनिक बजट ख़र्च होने से बहुत दूर हो।

अलग से, प्लेटफ़ॉर्म को स्थिर रखने के लिए पूरे API में व्यापक प्रति-IP और प्रति-खाता ऊपरी सीमाएँ लागू होती हैं। सामान्य उपयोग में — स्थिर, नियंत्रित गति वाले अनुरोध — आप इन्हें कभी नहीं छुएँगे; वे केवल दुरुपयोगी बर्स्ट पर ट्रिगर होती हैं।

  • Free और Basic — प्रति मिनट 60 अनुरोध।
  • Pro — प्रति मिनट 600 अनुरोध।
  • Business — प्रति मिनट 1,800 अनुरोध।
  • अनुरोधों को एक साथ दागने के बजाय उन्हें फैलाएँ।

4अपना शेष बजट पढ़ना

आपको कभी अनुमान नहीं लगाना पड़ता कि कितना कोटा बचा है। हर मीटर की गई प्रतिक्रिया — सफलता या विफलता — में तीन headers शामिल होते हैं: X-Quota-Limit (आपकी दैनिक सीमा), X-Quota-Used (आपने आज कितनी कॉल ख़र्च कीं), और X-Quota-Reset (वह क्षण, UTC में, जब काउंटर रीसेट होता है)।

spam-check endpoints वही संख्याएँ प्रतिक्रिया body में एक quota ऑब्जेक्ट के तहत भी दोहराते हैं, ताकि आप headers पार्स किए बिना अपना शेष बजट पढ़ सकें। इन्हें अपने अनुरोधों को गति देने और ख़त्म होने से पहले ख़ुद को चेताने के लिए उपयोग करें।

  • X-Quota-Limit — आपकी दैनिक कॉल सीमा।
  • X-Quota-Used — आज अब तक ख़र्च की गई कॉल।
  • X-Quota-Reset — UTC में रीसेट समय (RFC 3339)।
  • spam-check प्रतिक्रियाओं में वही फ़ील्ड वाला एक quota ऑब्जेक्ट भी शामिल होता है।

5429 पर क्या होता है

जब आप किसी भी सीमा को पार करते हैं, तो API एक Retry-After header के साथ HTTP 429 लौटाता है जो बताता है कि कितने सेकंड प्रतीक्षा करनी है। प्रति-मिनट rate limit के लिए, Retry-After लगभग एक मिनट है। दैनिक कोटा के लिए, body एक daily_quota_exceeded कोड और आपका प्लान, सीमा, used गिनती, रीसेट समय, और एक अपग्रेड संकेत ले जाता है, और Retry-After मध्यरात्रि UTC तक उलटी गिनती करता है।

429 संभालने का सही तरीक़ा है Retry-After विलंब के बाद पीछे हटना और पुनः प्रयास करना, न कि endpoint को बार-बार दागना। सही ढंग से बने क्लाइंट header पढ़ते हैं और रुकते हैं; जो क्लाइंट तुरंत पुनः प्रयास करते रहते हैं वे बस अवरुद्ध रहते हैं।

  • 429 rate_limit_exceeded — आपने बहुत तेज़ भेजा; लगभग एक मिनट प्रतीक्षा करें।
  • 429 daily_quota_exceeded — दिन इस्तेमाल हो गया; UTC रीसेट तक प्रतीक्षा करें या अपग्रेड करें।
  • पुनः प्रयास से पहले हमेशा Retry-After header का सम्मान करें।
हर प्रतिक्रिया पर X-Quota-Used को X-Quota-Limit के मुक़ाबले पढ़ें और सीमा के पास आते ही धीमे हो जाएँ, ताकि आप 429 की दीवार से अचानक टकराने के बजाय सहजता से धीमे पड़ें।
क्या यह लेख मददगार था?

अपने ग्रुप की रक्षा के लिए तैयार हैं?

Telm को अपने Telegram ग्रुप में जोड़ें और उसे स्पैम संभालने दें।

संबंधित लेख