{"title":"API Overview और Base URL","slug":"overview","category":"api","summary":"एक नज़र में सभी Synapse API एंडपॉइंट्स, base URL, प्रमाणीकरण पैटर्न, और प्रतिक्रिया प्रारूप।","audience":["human","llm"],"tags":["api","overview","endpoints"],"difficulty":"beginner","updated":"2026-06-27","word_count":578,"read_minutes":3,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)\n OR ?key=YOUR_MIND_KEY (query, 60 req/min)\nAll responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)\nAll 404 responses mean the path does not exist — do NOT guess paths.\nGET /endpoints returns machine-readable list of all valid endpoints.\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# API Overview और Base URL\n\nSynapse API एक RESTful HTTP API है। सभी एंडपॉइंट्स JSON लौटाते हैं (जहाँ उल्लेख किया गया है वहाँ को छोड़कर)। यह पृष्ठ विशिष्ट एंडपॉइंट्स में गोता लगाने से पहले आवश्यक मूल बातें कवर करता है।\n\n## Base URL\n\n```\nhttps://synapse.schaefer.zone\n```\n\nइस दस्तावेज़ीकरण के सभी पाथ इस base URL के सापेक्ष हैं। सेल्फ-होस्टेड इंस्टेंस के लिए, अपने स्वयं के URL से बदलें।\n\n## प्रमाणीकरण\n\nदो विधियाँ, दोनों `Authorization` हेडर के माध्यम से भेजी जाती हैं:\n\n```\nAuthorization: Bearer YOUR_MIND_KEY # for data endpoints\nAuthorization: Bearer YOUR_JWT # for account endpoints\n```\n\nया क्वेरी पैरामीटर के माध्यम से (60/min तक सीमित):\n\n```\n?key=YOUR_MIND_KEY\n```\n\nविवरण के लिए [प्रमाणीकरण](/docs/getting-started/authentication) देखें।\n\n## एंडपॉइंट समूह\n\n| समूह | प्रमाणीकरण | विवरण |\n|-------|------|-------------|\n| Public | कोई नहीं | लैंडिंग पृष्ठ, स्वास्थ्य, OpenAPI, दस्तावेज़ |\n| Memory | Mind Key | CRUD, खोज, सिंक, एम्बेडिंग |\n| Chat | Mind Key / JWT | मानव और एजेंट के बीच अतुल्यकालिक मैसेजिंग |\n| Tasks | Mind Key | कार्य प्रबंधन |\n| Scripts | Mind Key / JWT | स्थायी स्क्रिप्ट स्टोर |\n| Scheduler | Mind Key | Cron कार्य + वेरिएबल्स |\n| Webhooks | Mind Key | घटनाओं पर HTTP कॉलबैक |\n| Computers | Mind Key / JWT | रिमोट कंप्यूटर नियंत्रण |\n| User/Minds | JWT | खाता + mind प्रबंधन |\n| Sharing | JWT | उपयोगकर्ताओं के बीच mind साझाकरण |\n| Push | JWT | Web Push सब्सक्रिप्शन |\n| Tools | कोई नहीं | समय, calc, random (सार्वजनिक उपयोगिताएँ) |\n\n## प्रतिक्रिया प्रारूप\n\n- **JSON** (डिफ़ॉल्ट): `{ \"key\": \"value\", ... }`\n- **सादा टेक्स्ट**: `/memory/recall` LLM-अनुकूलित टेक्स्ट लौटाता है\n- **HTML**: `/`, `/docs`, `/human`, `/support`, `/playground`\n\n## मानक प्रतिक्रिया लिफ़ाफ़ा\n\nसफलता प्रतिक्रियाएँ सीधे डेटा लौटाती हैं:\n\n```json\n{ \"id\": \"mem_001\", \"status\": \"stored\" }\n```\n\nत्रुटि प्रतिक्रियाएँ इस प्रारूप का उपयोग करती हैं:\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> [!NOTE]\n> `docs` फ़ील्ड सामान्य त्रुटियों के लिए प्रासंगिक दस्तावेज़ीकरण से लिंक करता है।\n\n## HTTP स्टेटस कोड\n\n| कोड | अर्थ |\n|------|---------|\n| 200 | सफलता (GET, PUT) |\n| 201 | बनाया गया (POST) |\n| 204 | कोई सामग्री नहीं (DELETE) |\n| 400 | खराब अनुरोध (सत्यापन त्रुटि) |\n| 401 | अनधिकृत (गायब/अमान्य टोकन) |\n| 403 | निषिद्ध (गलत टोकन प्रकार) |\n| 404 | नहीं मिला (पाथ मौजूद नहीं है) |\n| 409 | टकराव (डुप्लिकेट) |\n| 429 | बहुत अधिक अनुरोध (रेट लिमिट) |\n| 500 | सर्वर त्रुटि |\n\n## खोज क्षमता एंडपॉइंट्स\n\n| एंडपॉइंट | उद्देश्य |\n|----------|---------|\n| `GET /` | लैंडिंग पृष्ठ (LLM-अनुकूलित) |\n| `GET /endpoints` | सभी एंडपॉइंट्स की मशीन-पठनीय सूची |\n| `GET /endpoints?format=text` | सादे-टेक्स्ट एंडपॉइंट सूची |\n| `GET /openapi.json` | OpenAPI 3.0 विशेषता |\n| `GET /help` | पूर्ण API दस्तावेज़ीकरण (HTML) |\n| `GET /help?format=json` | JSON के रूप में API दस्तावेज़ |\n| `GET /docs` | दस्तावेज़ीकरण सिस्टम (HTML) |\n| `GET /docs?format=json` | दस्तावेज़ीकरण सूचकांक (JSON) |\n| `GET /docs?format=text&scope=all` | सभी दस्तावेज़ एक टेक्स्ट ब्लॉक के रूप में |\n| `GET /playground` | इंटरैक्टिव API प्लेग्राउंड |\n\n## रेट लिमिट\n\n| प्रमाणीकरण विधि | सीमा |\n|-------------|-------|\n| Mind Key (हेडर) | कोई नहीं |\n| Mind Key (?key=) | प्रति IP 60/min |\n| JWT (हेडर) | कोई नहीं |\n| सार्वजनिक एंडपॉइंट्स | कोई नहीं |\n\nरेट-लिमिटेड प्रतिक्रियाएँ शामिल करती हैं:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nRetry-After: 30 (only when 429)\n```\n\n## पेजिनेशन\n\nसूची एंडपॉइंट्स `?limit=` और `?offset=` का समर्थन करते हैं:\n\n```\nGET /memory?limit=50&offset=100\nGET /mind/tasks?status=pending\n```\n\nडिफ़ॉल्ट सीमा: 100। अधिकतम सीमा: 500।\n\n## CORS\n\nसभी एंडपॉइंट्स ब्राउज़र-आधारित क्लाइंट्स के लिए CORS का समर्थन करते हैं:\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, Mcp-Session-Id, Mcp-Tool-Profile\n```\n\n## SDKs और क्लाइंट्स\n\n- **Node.js SDK**: `npm install synapse-memory-sdk` ([repo](https://gitlab.com/schaefer-services/synapse-sdk-js))\n- **MCP Server**: `npx -y synapse-mcp-api@latest` ([repo](https://gitlab.com/schaefer-services/synapse-mcp))\n- **HTTP client**: कोई भी HTTP लाइब्रेरी (curl, fetch, axios, आदि)\n\n## अगले कदम\n\n- [Memory API](/docs/api/memory) — सबसे महत्वपूर्ण एंडपॉइंट्स\n- [Chat API](/docs/api/chat) — अतुल्यकालिक मानव-एजेंट संचार\n- [त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors)\n","content_html":"

API Overview और Base URL

\n

Synapse API एक RESTful HTTP API है। सभी एंडपॉइंट्स JSON लौटाते हैं (जहाँ उल्लेख किया गया है वहाँ को छोड़कर)। यह पृष्ठ विशिष्ट एंडपॉइंट्स में गोता लगाने से पहले आवश्यक मूल बातें कवर करता है।

\n

Base URL

\n
https://synapse.schaefer.zone

इस दस्तावेज़ीकरण के सभी पाथ इस base URL के सापेक्ष हैं। सेल्फ-होस्टेड इंस्टेंस के लिए, अपने स्वयं के URL से बदलें।

\n

प्रमाणीकरण

\n

दो विधियाँ, दोनों Authorization हेडर के माध्यम से भेजी जाती हैं:

\n
Authorization: Bearer YOUR_MIND_KEY    # for data endpoints\nAuthorization: Bearer YOUR_JWT          # for account endpoints

या क्वेरी पैरामीटर के माध्यम से (60/min तक सीमित):

\n
?key=YOUR_MIND_KEY

विवरण के लिए प्रमाणीकरण देखें।

\n

एंडपॉइंट समूह

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
समूहप्रमाणीकरणविवरण
Publicकोई नहींलैंडिंग पृष्ठ, स्वास्थ्य, OpenAPI, दस्तावेज़
MemoryMind KeyCRUD, खोज, सिंक, एम्बेडिंग
ChatMind Key / JWTमानव और एजेंट के बीच अतुल्यकालिक मैसेजिंग
TasksMind Keyकार्य प्रबंधन
ScriptsMind Key / JWTस्थायी स्क्रिप्ट स्टोर
SchedulerMind KeyCron कार्य + वेरिएबल्स
WebhooksMind Keyघटनाओं पर HTTP कॉलबैक
ComputersMind Key / JWTरिमोट कंप्यूटर नियंत्रण
User/MindsJWTखाता + mind प्रबंधन
SharingJWTउपयोगकर्ताओं के बीच mind साझाकरण
PushJWTWeb Push सब्सक्रिप्शन
Toolsकोई नहींसमय, calc, random (सार्वजनिक उपयोगिताएँ)
\n

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

\n\n

मानक प्रतिक्रिया लिफ़ाफ़ा

\n

सफलता प्रतिक्रियाएँ सीधे डेटा लौटाती हैं:

\n
{ "id": "mem_001", "status": "stored" }

त्रुटि प्रतिक्रियाएँ इस प्रारूप का उपयोग करती हैं:

\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}
`docs` फ़ील्ड सामान्य त्रुटियों के लिए प्रासंगिक दस्तावेज़ीकरण से लिंक करता है।

HTTP स्टेटस कोड

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
कोडअर्थ
200सफलता (GET, PUT)
201बनाया गया (POST)
204कोई सामग्री नहीं (DELETE)
400खराब अनुरोध (सत्यापन त्रुटि)
401अनधिकृत (गायब/अमान्य टोकन)
403निषिद्ध (गलत टोकन प्रकार)
404नहीं मिला (पाथ मौजूद नहीं है)
409टकराव (डुप्लिकेट)
429बहुत अधिक अनुरोध (रेट लिमिट)
500सर्वर त्रुटि
\n

खोज क्षमता एंडपॉइंट्स

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
एंडपॉइंटउद्देश्य
GET /लैंडिंग पृष्ठ (LLM-अनुकूलित)
GET /endpointsसभी एंडपॉइंट्स की मशीन-पठनीय सूची
GET /endpoints?format=textसादे-टेक्स्ट एंडपॉइंट सूची
GET /openapi.jsonOpenAPI 3.0 विशेषता
GET /helpपूर्ण API दस्तावेज़ीकरण (HTML)
GET /help?format=jsonJSON के रूप में API दस्तावेज़
GET /docsदस्तावेज़ीकरण सिस्टम (HTML)
GET /docs?format=jsonदस्तावेज़ीकरण सूचकांक (JSON)
GET /docs?format=text&scope=allसभी दस्तावेज़ एक टेक्स्ट ब्लॉक के रूप में
GET /playgroundइंटरैक्टिव API प्लेग्राउंड
\n

रेट लिमिट

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
प्रमाणीकरण विधिसीमा
Mind Key (हेडर)कोई नहीं
Mind Key (?key=)प्रति IP 60/min
JWT (हेडर)कोई नहीं
सार्वजनिक एंडपॉइंट्सकोई नहीं
\n

रेट-लिमिटेड प्रतिक्रियाएँ शामिल करती हैं:

\n
X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nRetry-After: 30  (only when 429)

पेजिनेशन

\n

सूची एंडपॉइंट्स ?limit= और ?offset= का समर्थन करते हैं:

\n
GET /memory?limit=50&offset=100\nGET /mind/tasks?status=pending

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

\n

CORS

\n

सभी एंडपॉइंट्स ब्राउज़र-आधारित क्लाइंट्स के लिए CORS का समर्थन करते हैं:

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

SDKs और क्लाइंट्स

\n\n

अगले कदम

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