# रेट लिमिट और कोटा
SUMMARY: Synapse API के लिए रेट लिमिट नीति — Bearer हेडर (असीमित), ?key= (60/min), सार्वजनिक एंडपॉइंट्स।

KEY CONTEXT:
Mind Key (Authorization: Bearer header) → NO rate limit
Mind Key (?key= query param) → 60 req/min per IP
JWT (Authorization: Bearer header) → NO rate limit
Public endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit
Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After
Recommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.

रेट लिमिट और कोटा
Synapse में एक सरल, अनुमानित रेट लिमिट नीति है जो दुरुपयोग को रोकने के लिए डिज़ाइन की गई है जबकि वैध उपयोग के रास्ते में नहीं आती।
रेट लिमिट नीति
| प्रमाणीकरण विधि | सीमा | दायरा |
|-------------|-------|-------|
| Mind Key () | कोई नहीं | प्रति-mind |
| Mind Key () | 60 req/min | प्रति-IP |
| JWT () | कोई नहीं | प्रति-उपयोगकर्ता |
| सार्वजनिक एंडपॉइंट्स | कोई नहीं | वैश्विक |
> [!TIP]
> संभव होने पर हमेशा  हेडर का उपयोग करें। इसकी कोई रेट लिमिट नहीं है।  का उपयोग केवल उन टूल्स के लिए करें जो कस्टम हेडर सेट नहीं कर सकते।
रेट लिमिट हेडर
जब आप  प्रमाणीकरण का उपयोग करते हैं, तो प्रतिक्रियाएँ रेट लिमिट हेडर शामिल करती हैं:
[CODE BLOCK]
जब आप सीमा पार करते हैं:
[CODE BLOCK]
जब आप रेट लिमिट हिट करते हैं
यदि आपको 429 मिलता है:
1. Authorization हेडर पर स्विच करें (अनुशंसित):
   [CODE BLOCK]
2. या  सेकंड प्रतीक्षा करें और पुनः प्रयास करें।
?key= सीमा क्यों मौजूद है
 क्वेरी पैरामीटर URL-केवल टूल्स (ब्राउज़र,  कमांड) के लिए सुविधाजनक है, लेकिन इसके सुरक्षा और प्रदर्शन निहितार्थ हैं:
- सुरक्षा: क्वेरी पैरामीटर सर्वर एक्सेस लॉग, ब्राउज़र इतिहास, और Referer हेडर में लॉग किए जाते हैं। उपयोग को सीमित करने से जोखिम कम होता है।
- प्रदर्शन: क्वेरी-पैरामीटर प्रमाणीकरण के लिए IP-आधारित रेट लिमिटर की आवश्यकता होती है (प्रति अनुरोध Redis लुकअप), जो विलंबता जोड़ता है। हेडर प्रमाणीकरण इसे छोड़ देता है।
- दुरुपयोग निवारण: लीक हुई  URL साझा और हैमर की जा सकती है। IP सीमा प्रभाव की दायरा सीमित रखती है।
अनुशंसित पैटर्न
LLM एजेंट्स
[CODE BLOCK]
ब्राउज़र-आधारित टूल्स
यदि आपका टूल केवल URL खोल सकता है:
[CODE BLOCK]
MCP server
MCP servers हमेशा  env var के माध्यम से हेडर प्रमाणीकरण का उपयोग करते हैं — कोई रेट लिमिट लागू नहीं होती।
बल्क आयात
बल्क ऑपरेशन्स (जैसे 1000 मेमोरीज़ आयात करना) के लिए, हमेशा हेडर प्रमाणीकरण का उपयोग करें।  के माध्यम से बल्क आयात 1 मिनट के भीतर रेट लिमिट हिट करेगा।
कोटा (Mind-स्तर)
वर्तमान में स्टोरेज आकार या मेमोरी गिनती पर कोई प्रति-mind कोटा नहीं है। सभी सीमाएँ डेटा स्तर पर नहीं, बल्कि प्रमाणीकरण/IP स्तर पर हैं। यह भविष्य में मल्टी-टैनेंट निष्पक्षता के लिए बदल सकता है।
अपने उपयोग की निगरानी
[CODE BLOCK]
अगले कदम
- प्रमाणीकरण
- त्रुटियाँ और त्रुटि प्रबंधन