# त्रुटियाँ और त्रुटि प्रबंधन
SUMMARY: HTTP स्टेटस कोड, त्रुटि प्रतिक्रिया प्रारूप, और सामान्य त्रुटियों से कैसे उबरें।

KEY CONTEXT:
Error format: { statusCode, error, message, docs? }
Common errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)
401 → check Mind Key/JWT, see /docs/getting-started/authentication
404 → wrong path, GET /endpoints for valid list, do NOT guess paths
429 → rate limited (?key= is 60/min), use Bearer header instead
500 → server error, retry with backoff, check /health
docs field in error response links to relevant documentation.

त्रुटियाँ और त्रुटि प्रबंधन
Synapse एक सुसंगत त्रुटि प्रतिक्रिया प्रारूप के साथ मानक HTTP स्टेटस कोड का उपयोग करता है। यह पृष्ठ बताता है कि त्रुटियों की व्याख्या कैसे करें और उनसे कैसे उबरें।
त्रुटि प्रतिक्रिया प्रारूप
सभी त्रुटियाँ इस संरचना के साथ JSON लौटाती हैं:
[CODE BLOCK]
| फ़ील्ड | विवरण |
|-------|-------------|
|  | HTTP स्टेटस कोड |
|  | HTTP स्टेटस नाम |
|  | मानव-पठनीय त्रुटि विवरण |
|  | प्रासंगिक दस्तावेज़ीकरण का URL (जब लागू हो) |
HTTP स्टेटस कोड
200 OK
सफलता। अनुरोध सही ढंग से संसाधित किया गया।
201 Created
सफलता। एक नया संसाधन बनाया गया (जैसे )।
204 No Content
सफलता। कोई बॉडी वापस नहीं लौटाई गई (जैसे )।
400 Bad Request
अनुरोध विकृत था। सामान्य कारण:
- आवश्यक JSON फ़ील्ड्स गायब
- अमान्य JSON सिंटैक्स
- अमान्य enum मान (जैसे गलत श्रेणी)
[CODE BLOCK]
समाधान: API दस्तावेज़ों के विरुद्ध अनुरोध बॉडी की जाँच करें। सुनिश्चित करें कि सभी आवश्यक फ़ील्ड्स मौजूद हैं और वैध मान रखते हैं।
401 Unauthorized
प्रमाणीकरण विफल। सामान्य कारण:
-  हेडर गायब
- अमान्य Mind Key या JWT
- Mind Key का उपयोग जहाँ JWT आवश्यक है (या इसके विपरीत)
[CODE BLOCK]
समाधान: अपने टोकन को सत्यापित करें। प्रमाणीकरण देखें।
403 Forbidden
आप प्रमाणित हैं लेकिन यह क्रिया करने की अनुमति नहीं है। सामान्य कारण:
- किसी अन्य उपयोगकर्ता के mind को हटाने का प्रयास
- Mind Key से मेमोरी सत्यापित करने का प्रयास (JWT आवश्यक)
- Mind अक्षम है
समाधान: जाँचें कि आप इस एंडपॉइंट के लिए सही टोकन प्रकार का उपयोग कर रहे हैं।
404 Not Found
अनुरोधित पाथ या संसाधन मौजूद नहीं है।
> [!CRITICAL]
> एंडपॉइंट पाथ का अनुमान न लगाएँ। केवल  में सूचीबद्ध पाथ मौजूद हैं। यदि आपको 404 मिलता है, तो आपने गलत पाथ का उपयोग किया है।
[CODE BLOCK]
समाधान: वैध एंडपॉइंट्स की सूची देखने के लिए  कॉल करें। अपने URL की सूची के साथ वर्ण-दर-वर्ण तुलना करें।
409 Conflict
अनुरोध मौजूदा स्थिति से टकराता है। सामान्य कारण:
- पहले से मौजूद ईमेल के साथ पंजीकरण का प्रयास
- डुप्लिकेट webhook URL
समाधान: एक अलग मान का उपयोग करें, या मौजूदा संसाधन को अपडेट करने के लिए  का उपयोग करें।
429 Too Many Requests
आपने रेट लिमिट हिट कर ली। केवल  क्वेरी पैरामीटर प्रमाणीकरण (60/min) पर लागू होता है।
[CODE BLOCK]
प्रतिक्रिया हेडर:
[CODE BLOCK]
समाधान:  हेडर पर स्विच करें (कोई रेट लिमिट नहीं), या  सेकंड प्रतीक्षा करें।
500 Internal Server Error
सर्वर त्रुटि। ऐसा नहीं होना चाहिए — यदि होता है, तो यह एक बग है।
समाधान:
1. घातीय बैकऑफ़ के साथ पुनः प्रयास करें (1s, 2s, 4s, 8s)
2. जाँचें कि सर्वर चालू है या नहीं 
3. यदि लगातार हो, तो त्रुटि की रिपोर्ट करें
503 Service Unavailable
सर्वर अस्थायी रूप से बंद है (जैसे परिनियोजन, डेटाबेस माइग्रेशन के दौरान)।
समाधान: प्रतीक्षा करें और पुनः प्रयास करें।  जाँचें।
पुनर्प्राप्ति पैटर्न
घातीय बैकऑफ़ के साथ पुनः प्रयास
[CODE BLOCK]
प्रमाणीकरण त्रुटि प्रबंधन
[CODE BLOCK]
सामान्य त्रुटि परिदृश्य
"Mind Key fehlt oder ungültig"
- आप  हेडर भूल गए
- आपने  उपयोग किया लेकिन कुंजी गलत है
- आप Mind Key आवश्यक होने पर JWT उपयोग कर रहे हैं
"Route not found"
- आपने ऐसा पाथ अनुमानित किया जो मौजूद नहीं है
- आपने क्रिया गलत उपयोग की (जैसे  vs )
- वैध पाथ के लिए  जाँचें
"Rate limit exceeded"
- आप  उपयोग कर रहे हैं और 60 req/min पार कर गए
-  हेडर पर स्विच करें
अगले कदम
- प्रमाणीकरण
- API Overview
- Rate Limits