{"title":"त्रुटियाँ और त्रुटि प्रबंधन","slug":"errors","category":"api","summary":"HTTP स्टेटस कोड, त्रुटि प्रतिक्रिया प्रारूप, और सामान्य त्रुटियों से कैसे उबरें।","audience":["human","llm"],"tags":["api","errors","troubleshooting","http"],"difficulty":"beginner","updated":"2026-06-27","word_count":576,"read_minutes":3,"llm_context":"Error format: { statusCode, error, message, docs? }\nCommon errors: 401 (auth), 404 (wrong path), 429 (rate limit), 500 (server)\n401 → check Mind Key/JWT, see /docs/getting-started/authentication\n404 → wrong path, GET /endpoints for valid list, do NOT guess paths\n429 → rate limited (?key= is 60/min), use Bearer header instead\n500 → server error, retry with backoff, check /health\ndocs field in error response links to relevant documentation.\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# त्रुटियाँ और त्रुटि प्रबंधन\n\nSynapse एक सुसंगत त्रुटि प्रतिक्रिया प्रारूप के साथ मानक HTTP स्टेटस कोड का उपयोग करता है। यह पृष्ठ बताता है कि त्रुटियों की व्याख्या कैसे करें और उनसे कैसे उबरें।\n\n## त्रुटि प्रतिक्रिया प्रारूप\n\nसभी त्रुटियाँ इस संरचना के साथ JSON लौटाती हैं:\n\n```json\n{\n \"statusCode\": 401,\n \"error\": \"Unauthorized\",\n \"message\": \"Mind Key fehlt oder ungültig.\",\n \"docs\": \"https://synapse.schaefer.zone/docs/getting-started/authentication\"\n}\n```\n\n| फ़ील्ड | विवरण |\n|-------|-------------|\n| `statusCode` | HTTP स्टेटस कोड |\n| `error` | HTTP स्टेटस नाम |\n| `message` | मानव-पठनीय त्रुटि विवरण |\n| `docs` | प्रासंगिक दस्तावेज़ीकरण का URL (जब लागू हो) |\n\n## HTTP स्टेटस कोड\n\n### 200 OK\n\nसफलता। अनुरोध सही ढंग से संसाधित किया गया।\n\n### 201 Created\n\nसफलता। एक नया संसाधन बनाया गया (जैसे `POST /memory`)।\n\n### 204 No Content\n\nसफलता। कोई बॉडी वापस नहीं लौटाई गई (जैसे `DELETE /memory/:id`)।\n\n### 400 Bad Request\n\nअनुरोध विकृत था। सामान्य कारण:\n\n- आवश्यक JSON फ़ील्ड्स गायब\n- अमान्य JSON सिंटैक्स\n- अमान्य enum मान (जैसे गलत श्रेणी)\n\n```json\n{\n \"statusCode\": 400,\n \"error\": \"Bad Request\",\n \"message\": \"category must be one of: identity, preference, fact, project, skill, mistake, context, note, credentials\"\n}\n```\n\n**समाधान:** API दस्तावेज़ों के विरुद्ध अनुरोध बॉडी की जाँच करें। सुनिश्चित करें कि सभी आवश्यक फ़ील्ड्स मौजूद हैं और वैध मान रखते हैं।\n\n### 401 Unauthorized\n\nप्रमाणीकरण विफल। सामान्य कारण:\n\n- `Authorization` हेडर गायब\n- अमान्य Mind Key या JWT\n- Mind Key का उपयोग जहाँ JWT आवश्यक है (या इसके विपरीत)\n\n```json\n{\n \"statusCode\": 401,\n \"error\": \"Unauthorized\",\n \"message\": \"Mind Key fehlt oder ungültig.\",\n \"docs\": \"https://synapse.schaefer.zone/docs/getting-started/authentication\"\n}\n```\n\n**समाधान:** अपने टोकन को सत्यापित करें। [प्रमाणीकरण](/docs/getting-started/authentication) देखें।\n\n### 403 Forbidden\n\nआप प्रमाणित हैं लेकिन यह क्रिया करने की अनुमति नहीं है। सामान्य कारण:\n\n- किसी अन्य उपयोगकर्ता के mind को हटाने का प्रयास\n- Mind Key से मेमोरी सत्यापित करने का प्रयास (JWT आवश्यक)\n- Mind अक्षम है\n\n**समाधान:** जाँचें कि आप इस एंडपॉइंट के लिए सही टोकन प्रकार का उपयोग कर रहे हैं।\n\n### 404 Not Found\n\nअनुरोधित पाथ या संसाधन मौजूद नहीं है।\n\n> [!CRITICAL]\n> **एंडपॉइंट पाथ का अनुमान न लगाएँ।** केवल `GET /endpoints` में सूचीबद्ध पाथ मौजूद हैं। यदि आपको 404 मिलता है, तो आपने गलत पाथ का उपयोग किया है।\n\n```json\n{\n \"statusCode\": 404,\n \"error\": \"Not Found\",\n \"message\": \"Route GET /memory/list not found\",\n \"docs\": \"https://synapse.schaefer.zone/docs/api/errors\"\n}\n```\n\n**समाधान:** वैध एंडपॉइंट्स की सूची देखने के लिए `GET /endpoints` कॉल करें। अपने URL की सूची के साथ वर्ण-दर-वर्ण तुलना करें।\n\n### 409 Conflict\n\nअनुरोध मौजूदा स्थिति से टकराता है। सामान्य कारण:\n\n- पहले से मौजूद ईमेल के साथ पंजीकरण का प्रयास\n- डुप्लिकेट webhook URL\n\n**समाधान:** एक अलग मान का उपयोग करें, या मौजूदा संसाधन को अपडेट करने के लिए `PUT` का उपयोग करें।\n\n### 429 Too Many Requests\n\nआपने रेट लिमिट हिट कर ली। केवल `?key=` क्वेरी पैरामीटर प्रमाणीकरण (60/min) पर लागू होता है।\n\n```json\n{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Use Authorization header for unlimited access.\"\n}\n```\n\nप्रतिक्रिया हेडर:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\n```\n\n**समाधान:** `Authorization: Bearer` हेडर पर स्विच करें (कोई रेट लिमिट नहीं), या `Retry-After` सेकंड प्रतीक्षा करें।\n\n### 500 Internal Server Error\n\nसर्वर त्रुटि। ऐसा नहीं होना चाहिए — यदि होता है, तो यह एक बग है।\n\n**समाधान:**\n\n1. घातीय बैकऑफ़ के साथ पुनः प्रयास करें (1s, 2s, 4s, 8s)\n2. जाँचें कि सर्वर चालू है या नहीं `GET /health`\n3. यदि लगातार हो, तो त्रुटि की रिपोर्ट करें\n\n### 503 Service Unavailable\n\nसर्वर अस्थायी रूप से बंद है (जैसे परिनियोजन, डेटाबेस माइग्रेशन के दौरान)।\n\n**समाधान:** प्रतीक्षा करें और पुनः प्रयास करें। `GET /health` जाँचें।\n\n## पुनर्प्राप्ति पैटर्न\n\n### घातीय बैकऑफ़ के साथ पुनः प्रयास\n\n```python\nimport time\nimport requests\n\ndef call_with_retry(url, max_retries=3):\n for attempt in range(max_retries):\n try:\n r = requests.get(url, headers={\"Authorization\": f\"Bearer {KEY}\"})\n if r.status_code == 429:\n wait = int(r.headers.get(\"Retry-After\", 60))\n time.sleep(wait)\n continue\n if r.status_code >= 500:\n time.sleep(2 ** attempt)\n continue\n return r\n except requests.RequestException:\n time.sleep(2 ** attempt)\n raise Exception(f\"Failed after {max_retries} retries\")\n```\n\n### प्रमाणीकरण त्रुटि प्रबंधन\n\n```python\ndef safe_call(url, key):\n r = requests.get(url, headers={\"Authorization\": f\"Bearer {key}\"})\n if r.status_code == 401:\n # Mind Key invalid — alert user\n raise AuthError(\"Mind Key invalid or expired\")\n return r\n```\n\n## सामान्य त्रुटि परिदृश्य\n\n### \"Mind Key fehlt oder ungültig\"\n\n- आप `Authorization` हेडर भूल गए\n- आपने `?key=` उपयोग किया लेकिन कुंजी गलत है\n- आप Mind Key आवश्यक होने पर JWT उपयोग कर रहे हैं\n\n### \"Route not found\"\n\n- आपने ऐसा पाथ अनुमानित किया जो मौजूद नहीं है\n- आपने क्रिया गलत उपयोग की (जैसे `GET /memory` vs `POST /memory`)\n- वैध पाथ के लिए `GET /endpoints` जाँचें\n\n### \"Rate limit exceeded\"\n\n- आप `?key=` उपयोग कर रहे हैं और 60 req/min पार कर गए\n- `Authorization: Bearer` हेडर पर स्विच करें\n\n## अगले कदम\n\n- [प्रमाणीकरण](/docs/getting-started/authentication)\n- [API Overview](/docs/api/overview)\n- [Rate Limits](/docs/api/rate-limits)\n","content_html":"

त्रुटियाँ और त्रुटि प्रबंधन

\n

Synapse एक सुसंगत त्रुटि प्रतिक्रिया प्रारूप के साथ मानक HTTP स्टेटस कोड का उपयोग करता है। यह पृष्ठ बताता है कि त्रुटियों की व्याख्या कैसे करें और उनसे कैसे उबरें।

\n

त्रुटि प्रतिक्रिया प्रारूप

\n

सभी त्रुटियाँ इस संरचना के साथ JSON लौटाती हैं:

\n

{\n  "statusCode": 401,\n  "error": "Unauthorized",\n  "message": "Mind Key fehlt oder ungültig.",\n  "docs": "https://synapse.schaefer.zone/docs/getting-started/authentication"\n}

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

फ़ील्ड	विवरण
`statusCode`	HTTP स्टेटस कोड
`error`	HTTP स्टेटस नाम
`message`	मानव-पठनीय त्रुटि विवरण
`docs`	प्रासंगिक दस्तावेज़ीकरण का URL (जब लागू हो)

\n

HTTP स्टेटस कोड

\n

200 OK

\n

सफलता। अनुरोध सही ढंग से संसाधित किया गया।

\n

201 Created

\n

सफलता। एक नया संसाधन बनाया गया (जैसे POST /memory)।

\n

204 No Content

\n

सफलता। कोई बॉडी वापस नहीं लौटाई गई (जैसे DELETE /memory/:id)।

\n

400 Bad Request

\n

अनुरोध विकृत था। सामान्य कारण:

\n

आवश्यक JSON फ़ील्ड्स गायब
अमान्य JSON सिंटैक्स
अमान्य enum मान (जैसे गलत श्रेणी)

\n

{\n  "statusCode": 400,\n  "error": "Bad Request",\n  "message": "category must be one of: identity, preference, fact, project, skill, mistake, context, note, credentials"\n}

समाधान: API दस्तावेज़ों के विरुद्ध अनुरोध बॉडी की जाँच करें। सुनिश्चित करें कि सभी आवश्यक फ़ील्ड्स मौजूद हैं और वैध मान रखते हैं।

\n

401 Unauthorized

\n

प्रमाणीकरण विफल। सामान्य कारण:

\n

Authorization हेडर गायब
अमान्य Mind Key या JWT
Mind Key का उपयोग जहाँ JWT आवश्यक है (या इसके विपरीत)

\n

{\n  "statusCode": 401,\n  "error": "Unauthorized",\n  "message": "Mind Key fehlt oder ungültig.",\n  "docs": "https://synapse.schaefer.zone/docs/getting-started/authentication"\n}

समाधान: अपने टोकन को सत्यापित करें। प्रमाणीकरण देखें।

\n

403 Forbidden

\n

आप प्रमाणित हैं लेकिन यह क्रिया करने की अनुमति नहीं है। सामान्य कारण:

\n

किसी अन्य उपयोगकर्ता के mind को हटाने का प्रयास
Mind Key से मेमोरी सत्यापित करने का प्रयास (JWT आवश्यक)
Mind अक्षम है

\n

समाधान: जाँचें कि आप इस एंडपॉइंट के लिए सही टोकन प्रकार का उपयोग कर रहे हैं।

\n

404 Not Found

\n

अनुरोधित पाथ या संसाधन मौजूद नहीं है।

\n

**एंडपॉइंट पाथ का अनुमान न लगाएँ।** केवल `GET /endpoints` में सूचीबद्ध पाथ मौजूद हैं। यदि आपको 404 मिलता है, तो आपने गलत पाथ का उपयोग किया है।

{\n  "statusCode": 404,\n  "error": "Not Found",\n  "message": "Route GET /memory/list not found",\n  "docs": "https://synapse.schaefer.zone/docs/api/errors"\n}

समाधान: वैध एंडपॉइंट्स की सूची देखने के लिए GET /endpoints कॉल करें। अपने URL की सूची के साथ वर्ण-दर-वर्ण तुलना करें।

\n

409 Conflict

\n

अनुरोध मौजूदा स्थिति से टकराता है। सामान्य कारण:

\n

पहले से मौजूद ईमेल के साथ पंजीकरण का प्रयास
डुप्लिकेट webhook URL

\n

समाधान: एक अलग मान का उपयोग करें, या मौजूदा संसाधन को अपडेट करने के लिए PUT का उपयोग करें।

\n

429 Too Many Requests

\n

आपने रेट लिमिट हिट कर ली। केवल ?key= क्वेरी पैरामीटर प्रमाणीकरण (60/min) पर लागू होता है।

\n

{\n  "statusCode": 429,\n  "error": "Too Many Requests",\n  "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}

प्रतिक्रिया हेडर:

\n

X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42

समाधान: Authorization: Bearer हेडर पर स्विच करें (कोई रेट लिमिट नहीं), या Retry-After सेकंड प्रतीक्षा करें।

\n

500 Internal Server Error

\n

सर्वर त्रुटि। ऐसा नहीं होना चाहिए — यदि होता है, तो यह एक बग है।

\n

समाधान:

\n

घातीय बैकऑफ़ के साथ पुनः प्रयास करें (1s, 2s, 4s, 8s)
जाँचें कि सर्वर चालू है या नहीं GET /health
यदि लगातार हो, तो त्रुटि की रिपोर्ट करें

\n

503 Service Unavailable

\n

सर्वर अस्थायी रूप से बंद है (जैसे परिनियोजन, डेटाबेस माइग्रेशन के दौरान)।

\n

समाधान: प्रतीक्षा करें और पुनः प्रयास करें। GET /health जाँचें।

\n

पुनर्प्राप्ति पैटर्न

\n

घातीय बैकऑफ़ के साथ पुनः प्रयास

\n

import time\nimport requests\n\ndef call_with_retry(url, max_retries=3):\n    for attempt in range(max_retries):\n        try:\n            r = requests.get(url, headers={"Authorization": f"Bearer {KEY}"})\n            if r.status_code == 429:\n                wait = int(r.headers.get("Retry-After", 60))\n                time.sleep(wait)\n                continue\n            if r.status_code >= 500:\n                time.sleep(2 ** attempt)\n                continue\n            return r\n        except requests.RequestException:\n            time.sleep(2 ** attempt)\n    raise Exception(f"Failed after {max_retries} retries")

प्रमाणीकरण त्रुटि प्रबंधन

\n

def safe_call(url, key):\n    r = requests.get(url, headers={"Authorization": f"Bearer {key}"})\n    if r.status_code == 401:\n        # Mind Key invalid — alert user\n        raise AuthError("Mind Key invalid or expired")\n    return r

सामान्य त्रुटि परिदृश्य

\n

"Mind Key fehlt oder ungültig"

\n

आप Authorization हेडर भूल गए
आपने ?key= उपयोग किया लेकिन कुंजी गलत है
आप Mind Key आवश्यक होने पर JWT उपयोग कर रहे हैं

\n

"Route not found"

\n

आपने ऐसा पाथ अनुमानित किया जो मौजूद नहीं है
आपने क्रिया गलत उपयोग की (जैसे GET /memory vs POST /memory)
वैध पाथ के लिए GET /endpoints जाँचें

\n

"Rate limit exceeded"

\n

आप ?key= उपयोग कर रहे हैं और 60 req/min पार कर गए
Authorization: Bearer हेडर पर स्विच करें

\n

अगले कदम

\n

\n","urls":{"html":"/docs/api/errors","text":"/docs/api/errors?format=text","json":"/docs/api/errors?format=json","llm":"/docs/api/errors?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}