दर सीमाएँ
हर API कुंजी की एक सतत अनुरोध-प्रति-सेकंड सीमा होती है जो आपके प्लान से प्राप्त होती है (Free 1 req/s → Max 60 req/s — देखें मूल्य निर्धारण)। सीमाएँ एक टोकन बकेट से लागू की जाती हैं: आपकी प्रति-मिनट क्षमता तक बर्स्ट की अनुमति है, फिर अनुरोधों को सतत दर तक सुचारू किया जाता है।
जब आप सीमित होते हैं
Section titled “जब आप सीमित होते हैं”{ "error": "rate_limited", "retry_after_ms": 850 }- HTTP
429,error: "rate_limited"। retry_after_msआपको रीट्राई करने से पहले प्रतीक्षा करने का न्यूनतम समय बताता है।- हर प्रतिक्रिया पर
x-ratelimit-remainingहेडर बताता है कि इस मिनट में कितने अनुरोध बचे हैं।
समवर्तीता
Section titled “समवर्तीता”प्रति-सेकंड दर के अलावा, इन-फ़्लाइट अनुरोधों पर एक सीमा होती है। यदि आप एक साथ कई अनुरोध दागते हैं तो आप यह देख सकते हैं:
409 request_in_progress— एक समरूप idempotent अनुरोध पहले से चल रहा है।503 too_many_concurrent_requests— फ़्लाइट में बहुत अधिक समवर्ती अनुरोध; बैक ऑफ़ करें और रीट्राई करें।
सीमाओं को संभालना
Section titled “सीमाओं को संभालना”retry_after_msका सम्मान करें; अन्यथा जिटर के साथ एक्सपोनेंशियल बैकऑफ़ का उपयोग करें।- अपने प्लान की दर से मिलान करते हुए एक क्लाइंट-साइड समवर्तीता सीमा रखें।
- आधिकारिक SDK
429/503को स्वतः रीट्राई करते हैं।