{"title":"API FAQ","slug":"api-faq","category":"faq","summary":"सामान्य API प्रश्न — प्रमाणीकरण, रेट लिमिट, त्रुटि प्रबंधन, एंडपॉइंट खोज।","audience":["human","llm"],"tags":["faq","api","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":432,"read_minutes":2,"lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# API FAQ\n\nSynapse API के बारे में सामान्य प्रश्न।\n\n## मैं प्रमाणित कैसे करूँ?\n\nदो विधियाँ:\n\n1. **Mind Key** (डेटा एंडपॉइंट्स के लिए): `Authorization: Bearer mk_...`\n2. **JWT** (खाता एंडपॉइंट्स के लिए): `Authorization: Bearer eyJ...`\n\nया क्वेरी पैरामीटर के माध्यम से (60 req/min सीमा): `?key=mk_...`\n\n[प्रमाणीकरण](/docs/getting-started/authentication) देखें।\n\n## Mind Key और JWT में क्या अंतर है?\n\n- **Mind Key**: टैनेंट-स्कोप्ड, कभी समाप्त नहीं होता, memory/chat/tasks डेटा के लिए\n- **JWT**: उपयोगकर्ता-स्कोप्ड, 7-दिन समाप्ति, खाता/mind प्रबंधन के लिए\n\n[Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) देखें।\n\n## मुझे 401 Unauthorized क्यों मिल रहा है?\n\nसामान्य कारण:\n\n1. `Authorization` हेडर गायब\n2. अमान्य Mind Key (सत्यापित करें कि यह `mk_` से शुरू होता है)\n3. Mind Key आवश्यक होने पर JWT का उपयोग (या इसके विपरीत)\n4. Mind Key रद्द कर दी गई\n\n**समाधान:** अपने टोकन को सत्यापित करें। [प्रमाणीकरण](/docs/getting-started/authentication) देखें।\n\n## मुझे 404 Not Found क्यों मिल रहा है?\n\nआपने गलत एंडपॉइंट पाथ का उपयोग किया। Synapse में केवल `GET /endpoints` में सूचीबद्ध पाथ हैं।\n\n**समाधान:** सभी वैध पाथ देखने के लिए `GET /endpoints` कॉल करें। अनुमान न लगाएँ।\n\n## मुझे 429 Too Many Requests क्यों मिल रहा है?\n\nआप `?key=` क्वेरी पैरामीटर प्रमाणीकरण का उपयोग कर रहे हैं, जो 60/min तक सीमित है।\n\n**समाधान:** `Authorization: Bearer` हेडर पर स्विच करें (कोई रेट लिमिट नहीं)।\n\n[रेट लिमिट](/docs/api/rate-limits) देखें।\n\n## मैं सभी एंडपॉइंट्स की सूची कैसे बनाऊँ?\n\n```bash\ncurl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text\n```\n\n## मुझे सही एंडपॉइंट कैसे मिले?\n\n1. मशीन-पठनीय सूची के लिए `GET /endpoints` जाँचें\n2. पूर्ण API दस्तावेज़ के लिए `GET /help` जाँचें\n3. दस्तावेज़ीकरण सिस्टम के लिए `GET /docs` ब्राउज़ करें\n4. OpenAPI 3.0 विशेषता के लिए `GET /openapi.json` का उपयोग करें\n\n## क्या मैं POST के बजाय GET का उपयोग कर सकता हूँ?\n\nकुछ POST एंडपॉइंट्स में URL-केवल टूल्स के लिए GET समकक्ष हैं:\n\n- `POST /memory` ↔ `GET /memory/store?content=...`\n- `POST /mind/task` ↔ `GET /mind/task?title=...`\n- `POST /chat/reply` ↔ `GET /chat/reply?content=...`\n\nउपलब्ध GET वेरिएंट्स के लिए `GET /endpoints` जाँचें।\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[त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors) देखें।\n\n## अनुरोध बॉडी सीमा क्या है?\n\n10 MB। बड़े payloads (जैसे फ़ाइल अपलोड) के लिए, multipart एंडपॉइंट्स का उपयोग करें।\n\n## क्या API CORS का समर्थन करता है?\n\nहाँ। सभी एंडपॉइंट्स लौटाते हैं:\n\n```\nAccess-Control-Allow-Origin: *\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\nAccess-Control-Allow-Headers: Authorization, Content-Type, X-Synapse-JWT\n```\n\n## क्या कोई SDK है?\n\nहाँ:\n\n- **Node.js**: `npm install synapse-memory-sdk`\n- **MCP**: `npx -y synapse-mcp-api@latest`\n\nविवरण के लिए [API Overview](/docs/api/overview) देखें।\n\n## मैं पेजिनेशन कैसे करूँ?\n\n`?limit=` और `?offset=` का उपयोग करें:\n\n```bash\ncurl \".../memory?limit=50&offset=100\"\n```\n\nडिफ़ॉल्ट सीमा: 100। अधिकतम: 500।\n\n## क्या मैं मेमोरीज़ को श्रेणी या टैग से फ़िल्टर कर सकता हूँ?\n\nहाँ:\n\n```bash\ncurl \".../memory?category=project\"\ncurl \".../memory?tag=docker\"\ncurl \".../memory/by-tag?tag=production\"\n```\n\n## मैं मेमोरीज़ कैसे खोजूँ?\n\nदो तरीके:\n\n1. **FTS5 कीवर्ड खोज**: `GET /memory/search?q=docker+swarm`\n2. **सिमेंटिक खोज**: `GET /memory/semantic-search?q=container+orchestration`\n\n[FTS5 Search](/docs/concepts/fts5-search) और [सिमेंटिक खोज](/docs/concepts/semantic-search) देखें।\n\n## मैं मेमोरी कैसे अपडेट करूँ?\n\nसमान `category` + `key` के साथ POST `/memory` — मौजूदा मेमोरी अपडेट होती है, डुप्लिकेट नहीं होती।\n\n```bash\n# Initial store\ncurl -X POST .../memory -d '{\"category\":\"fact\",\"key\":\"user_name\",\"content\":\"Michael\"}'\n\n# Update (same key)\ncurl -X POST .../memory -d '{\"category\":\"fact\",\"key\":\"user_name\",\"content\":\"Michael Schäfer\"}'\n```\n\n## मैं मेमोरी कैसे हटाऊँ?\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## क्या मैं बल्क हटा सकता हूँ?\n\nहाँ:\n\n```bash\ncurl -X POST .../memory/bulk-delete \\\n -d '{\"ids\": [\"mem_001\", \"mem_002\", \"mem_003\"]}'\n```\n\n## अगले कदम\n\n- [API Overview](/docs/api/overview)\n- [त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors)\n- [प्रमाणीकरण](/docs/getting-started/authentication)\n","content_html":"

API FAQ

\n

Synapse API के बारे में सामान्य प्रश्न।

\n

मैं प्रमाणित कैसे करूँ?

\n

दो विधियाँ:

\n
    \n
  1. Mind Key (डेटा एंडपॉइंट्स के लिए): Authorization: Bearer mk_...
    2. \n
  2. JWT (खाता एंडपॉइंट्स के लिए): Authorization: Bearer eyJ...
    3. \n
\n

या क्वेरी पैरामीटर के माध्यम से (60 req/min सीमा): ?key=mk_...

\n

प्रमाणीकरण देखें।

\n

Mind Key और JWT में क्या अंतर है?

\n\n

Mind Key vs JWT देखें।

\n

मुझे 401 Unauthorized क्यों मिल रहा है?

\n

सामान्य कारण:

\n
    \n
  1. Authorization हेडर गायब
    2. \n
  2. अमान्य Mind Key (सत्यापित करें कि यह mk_ से शुरू होता है)
    3. \n
  3. Mind Key आवश्यक होने पर JWT का उपयोग (या इसके विपरीत)
    4. \n
  4. Mind Key रद्द कर दी गई
    5. \n
\n

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

\n

मुझे 404 Not Found क्यों मिल रहा है?

\n

आपने गलत एंडपॉइंट पाथ का उपयोग किया। Synapse में केवल GET /endpoints में सूचीबद्ध पाथ हैं।

\n

समाधान: सभी वैध पाथ देखने के लिए GET /endpoints कॉल करें। अनुमान न लगाएँ।

\n

मुझे 429 Too Many Requests क्यों मिल रहा है?

\n

आप ?key= क्वेरी पैरामीटर प्रमाणीकरण का उपयोग कर रहे हैं, जो 60/min तक सीमित है।

\n

समाधान: Authorization: Bearer हेडर पर स्विच करें (कोई रेट लिमिट नहीं)।

\n

रेट लिमिट देखें।

\n

मैं सभी एंडपॉइंट्स की सूची कैसे बनाऊँ?

\n
curl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text

मुझे सही एंडपॉइंट कैसे मिले?

\n
    \n
  1. मशीन-पठनीय सूची के लिए GET /endpoints जाँचें
    2. \n
  2. पूर्ण API दस्तावेज़ के लिए GET /help जाँचें
    3. \n
  3. दस्तावेज़ीकरण सिस्टम के लिए GET /docs ब्राउज़ करें
    4. \n
  4. OpenAPI 3.0 विशेषता के लिए GET /openapi.json का उपयोग करें
    5. \n
\n

क्या मैं POST के बजाय GET का उपयोग कर सकता हूँ?

\n

कुछ POST एंडपॉइंट्स में URL-केवल टूल्स के लिए GET समकक्ष हैं:

\n\n

उपलब्ध GET वेरिएंट्स के लिए GET /endpoints जाँचें।

\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

10 MB। बड़े payloads (जैसे फ़ाइल अपलोड) के लिए, multipart एंडपॉइंट्स का उपयोग करें।

\n

क्या API CORS का समर्थन करता है?

\n

हाँ। सभी एंडपॉइंट्स लौटाते हैं:

\n
Access-Control-Allow-Origin: *\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\nAccess-Control-Allow-Headers: Authorization, Content-Type, X-Synapse-JWT

क्या कोई SDK है?

\n

हाँ:

\n\n

विवरण के लिए API Overview देखें।

\n

मैं पेजिनेशन कैसे करूँ?

\n

?limit= और ?offset= का उपयोग करें:

\n
curl ".../memory?limit=50&offset=100"

डिफ़ॉल्ट सीमा: 100। अधिकतम: 500।

\n

क्या मैं मेमोरीज़ को श्रेणी या टैग से फ़िल्टर कर सकता हूँ?

\n

हाँ:

\n
curl ".../memory?category=project"\ncurl ".../memory?tag=docker"\ncurl ".../memory/by-tag?tag=production"

मैं मेमोरीज़ कैसे खोजूँ?

\n

दो तरीके:

\n
    \n
  1. FTS5 कीवर्ड खोज: GET /memory/search?q=docker+swarm
    2. \n
  2. सिमेंटिक खोज: GET /memory/semantic-search?q=container+orchestration
    3. \n
\n

FTS5 Search और सिमेंटिक खोज देखें।

\n

मैं मेमोरी कैसे अपडेट करूँ?

\n

समान category + key के साथ POST /memory — मौजूदा मेमोरी अपडेट होती है, डुप्लिकेट नहीं होती।

\n
# Initial store\ncurl -X POST .../memory -d '{"category":"fact","key":"user_name","content":"Michael"}'\n\n# Update (same key)\ncurl -X POST .../memory -d '{"category":"fact","key":"user_name","content":"Michael Schäfer"}'

मैं मेमोरी कैसे हटाऊँ?

\n
curl -X DELETE -H "Authorization: Bearer $KEY" \\\n     https://synapse.schaefer.zone/memory/mem_001

क्या मैं बल्क हटा सकता हूँ?

\n

हाँ:

\n
curl -X POST .../memory/bulk-delete \\\n  -d '{"ids": ["mem_001", "mem_002", "mem_003"]}'

अगले कदम

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