सीमा तक पहुँचने से पहले अपनी कुंजी के उपयोग पर नज़र रखें
काम के साथ-साथ अपने कोटा हेडर देखते रहने से पता चलता है कि कब सीमा करीब आ रही है, किसी अनुरोध के असल में अस्वीकार होने से काफ़ी पहले।
X-Quota-Used और X-Quota-Limit हेडर को सही तरह से पढ़ें
API का हर रिस्पॉन्स, सफल हो या नहीं, हेडर का एक सेट लेकर आता है जो ठीक-ठीक बताता है कि आप अपने कोटा के मुक़ाबले कहाँ हैं। इन्हें सही तरीके से पढ़ने का मतलब है यह समझना कि हर हेडर क्या गिनता है।
मुख्य जोड़ी
X-Quota-Limit आपके मौजूदा कोटा का आकार है, या तो मुफ़्त दैनिक कोटा या Unlimited पैकेज के तहत प्रभावी सीमा। X-Quota-Used बताता है कि मौजूदा अवधि में अब तक कितने अनुरोध उस कोटा में गिने गए हैं। एक को दूसरे से हाथ से घटाने की ज़रूरत नहीं है, क्योंकि X-Quota-Free-Remaining यह पहले से आपके लिए करता है।
HTTP/1.1 200 OK
X-Quota-Limit: 2500
X-Quota-Used: 1840
X-Quota-Free-Remaining: 660
X-Quota-Network-Used: 1840
X-Credits-Remaining: 0.00
X-Key-IPs-Used: 1
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Zकुंजी का उपयोग बनाम नेटवर्क का उपयोग
X-Quota-Used आपकी कुंजी से जुड़े उपयोग को दर्शाता है, जबकि X-Quota-Network-Used आसपास के नेटवर्क के उपयोग को दर्शाता है, क्योंकि मुफ़्त कोटा एक ही /24 के हर IPv4 पते और एक ही /48 के हर IPv6 पते के बीच साझा होता है, चाहे कुंजी शामिल हो या नहीं। अगर किसी कुंजी को एक ही पता ब्लॉक के पीछे के कई सर्वरों से कॉल किया जाता है, तो नेटवर्क का आंकड़ा किसी एक सर्वर की अपने ट्रैफ़िक से की गई अपेक्षा से तेज़ी से बढ़ेगा।
IP स्लॉट की जोड़ी
X-Key-IPs-Used और X-Key-IPs-Limit एक पूरी तरह अलग चीज़ बताते हैं: हाल में कितने अलग-अलग स्रोत पतों ने इस ख़ास कुंजी का उपयोग किया है, प्रति कुंजी अनुमत दो या तीन पतों की रोलिंग सीमा के मुक़ाबले। एक ही सर्वर से कॉल की जाने वाली कुंजी यहाँ लगातार 1 दिखाएगी। कई असंबंधित सर्वरों में साझा की गई कुंजी, या किसी ऐसी स्क्रिप्ट में कॉपी की गई कुंजी जो आख़िर में कई मशीनों से चलने लगे, सीमा की ओर बढ़ेगी। इस पर अपने अनुरोध कोटा से अलग नज़र रखना सार्थक है, क्योंकि यह किसी कुंजी को तब भी ब्लॉक कर सकता है जब बहुत सारे मुफ़्त अनुरोध बचे हों।
क्रेडिट और रीसेट का समय
X-Credits-Remaining आपका प्रीपेड बैलेंस दिखाता है, जब आप मुफ़्त कोटा से आगे निकल चुके हों और €0.0001 प्रति अनुरोध पर क्रेडिट उपयोग कर रहे हों। X-Quota-Reset ठीक-ठीक बताता है कि मौजूदा दैनिक कोटा कब रीसेट होगा, जो अपनी घड़ी के आधार पर कोई तय समय मान लेने से ज़्यादा भरोसेमंद है।
इन हेडर के आधार पर क्या बनाएँ
एक डैशबोर्ड, एक अलर्ट, या बस एक लॉग लाइन जो हर कॉल के बाद इन हेडर को पढ़े, आपको उपयोग की लाइव तस्वीर देती है, बिना किसी अलग रिपोर्टिंग कॉल के, क्योंकि संख्याएँ उसी रिस्पॉन्स पर आती हैं जो आपने पहले ही माँगा था। इन्हें पढ़ने में कोई अतिरिक्त लागत नहीं है, क्योंकि ये उस हर अनुरोध के साथ आते हैं जो आप पहले से भेज रहे थे, चाहे वह अनुरोध सफल हुआ हो या त्रुटि के रूप में लौटा हो।
एक गलती जिससे बचना चाहिए
इन हेडर को केवल कुछ ग़लत होने पर पढ़ने का मतलब है कि आपको कोटा की समस्या का पता उसी क्षण चलेगा जब आपके उपयोगकर्ताओं को। कम से कम X-Quota-Free-Remaining और X-Credits-Remaining को नियमित रूप से, या कम ट्रैफ़िक वाले इंटीग्रेशन में हर कॉल के बाद, लॉग करें, ताकि सीमा की ओर धीमी बढ़त अचानक आए 429 रिस्पॉन्स के झुंड के बजाय डैशबोर्ड में एक रुझान के रूप में दिखे।
किसी समस्या को देखने के लिए 429 का इंतज़ार करने के बजाय हर रिस्पॉन्स पर कोटा हेडर पढ़ना, सहज तरीके से धीमा होने और अचानक चौंकने के बीच का अंतर है। हेडर की पूरी सूची रेट लिमिट पेज पर दर्ज है।