{"title":"คำถามที่พบบ่อยเกี่ยวกับ API","slug":"api-faq","category":"faq","summary":"คำถามทั่วไปเกี่ยวกับ Synapse API — auth, rate limit, การจัดการ error, การค้นพบ endpoint","audience":["human","llm"],"tags":["faq","api","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":289,"read_minutes":1,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# คำถามที่พบบ่อยเกี่ยวกับ API\n\nคำถามทั่วไปเกี่ยวกับ Synapse API\n\n## ฉันยืนยันตัวตนอย่างไร?\n\nสองวิธี:\n\n1. **Mind Key** (สำหรับ endpoint ข้อมูล): `Authorization: Bearer mk_...`\n2. **JWT** (สำหรับ endpoint บัญชี): `Authorization: Bearer eyJ...`\n\nหรือผ่าน query parameter (จำกัด 60 req/min): `?key=mk_...`\n\nดู [Authentication](/docs/getting-started/authentication)\n\n## ความแตกต่างระหว่าง Mind Key และ JWT คืออะไร?\n\n- **Mind Key**: tenant-scoped, ไม่หมดอายุ, สำหรับข้อมูล memory/chat/tasks\n- **JWT**: user-scoped, หมดอายุ 7 วัน, สำหรับการจัดการบัญชี/mind\n\nดู [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt)\n\n## ทำไมฉันได้ 401 Unauthorized?\n\nสาเหตุทั่วไป:\n\n1. ขาด `Authorization` header\n2. Mind Key ไม่ถูกต้อง (ตรวจว่าขึ้นต้นด้วย `mk_`)\n3. ใช้ JWT ในที่ที่ต้องใช้ Mind Key (หรือกลับกัน)\n4. Mind Key ถูกเพิกถอน\n\n**วิธีแก้:** ตรวจสอบ token ของคุณ ดู [Authentication](/docs/getting-started/authentication)\n\n## ทำไมฉันได้ 404 Not Found?\n\nคุณใช้ endpoint path ผิด Synapse มีเพียง path ที่แสดงใน `GET /endpoints`\n\n**วิธีแก้:** เรียก `GET /endpoints` เพื่อดู path ที่ถูกต้องทั้งหมด อย่าเดา\n\n## ทำไมฉันได้ 429 Too Many Requests?\n\nคุณใช้ auth ผ่าน `?key=` query parameter ซึ่งจำกัดที่ 60/min\n\n**วิธีแก้:** เปลี่ยนไปใช้ `Authorization: Bearer` header (ไม่จำกัดอัตรา)\n\nดู [Rate Limits](/docs/api/rate-limits)\n\n## ฉันจะระบุ endpoint ทั้งหมดได้อย่างไร?\n\n```bash\ncurl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text\n```\n\n## ฉันจะหา endpoint ที่เหมาะสมได้อย่างไร?\n\n1. ตรวจ `GET /endpoints` สำหรับรายการ machine-readable\n2. ตรวจ `GET /help` สำหรับ API docs แบบเต็ม\n3. ดู `GET /docs` สำหรับระบบเอกสาร\n4. ใช้ `GET /openapi.json` สำหรับ OpenAPI 3.0 spec\n\n## ฉันใช้ GET แทน POST ได้ไหม?\n\nPOST endpoint บางตัวมี GET equivalent สำหรับเครื่องมือ URL-only:\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 /endpoints` สำหรับ GET variant ที่มี\n\n## ฉันจัดการ error อย่างไร?\n\nerror ทั้งหมดส่งกลับเป็น 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ดู [Errors & Error Handling](/docs/api/errors)\n\n## ขีดจำกัดขนาด request body คือเท่าไร?\n\n10 MB สำหรับ payload ที่ใหญ่กว่า (เช่น อัปโหลดไฟล์) ให้ใช้ multipart endpoint\n\n## API รองรับ CORS ไหม?\n\nใช่ ทุก endpoint ส่งกลับ:\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## ฉันทำ pagination อย่างไร?\n\nใช้ `?limit=` และ `?offset=`:\n\n```bash\ncurl \".../memory?limit=50&offset=100\"\n```\n\nLimit เริ่มต้น: 100 สูงสุด: 500\n\n## ฉันกรอง memory ตาม category หรือ tag ได้ไหม?\n\nได้:\n\n```bash\ncurl \".../memory?category=project\"\ncurl \".../memory?tag=docker\"\ncurl \".../memory/by-tag?tag=production\"\n```\n\n## ฉันค้นหา memory อย่างไร?\n\nสองวิธี:\n\n1. **FTS5 keyword search**: `GET /memory/search?q=docker+swarm`\n2. **Semantic search**: `GET /memory/semantic-search?q=container+orchestration`\n\nดู [FTS5 Search](/docs/concepts/fts5-search) และ [Semantic Search](/docs/concepts/semantic-search)\n\n## ฉันอัปเดต memory อย่างไร?\n\nPOST `/memory` ด้วย `category` + `key` เดิม — 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## ฉันลบ memory อย่างไร?\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- [Errors & Error Handling](/docs/api/errors)\n- [Authentication](/docs/getting-started/authentication)\n","content_html":"

คำถามที่พบบ่อยเกี่ยวกับ API

\n

คำถามทั่วไปเกี่ยวกับ Synapse API

\n

ฉันยืนยันตัวตนอย่างไร?

\n

สองวิธี:

\n
    \n
  1. Mind Key (สำหรับ endpoint ข้อมูล): Authorization: Bearer mk_...
    2. \n
  2. JWT (สำหรับ endpoint บัญชี): Authorization: Bearer eyJ...
    3. \n
\n

หรือผ่าน query parameter (จำกัด 60 req/min): ?key=mk_...

\n

ดู Authentication

\n

ความแตกต่างระหว่าง Mind Key และ JWT คืออะไร?

\n\n

ดู Mind Key vs JWT

\n

ทำไมฉันได้ 401 Unauthorized?

\n

สาเหตุทั่วไป:

\n
    \n
  1. ขาด Authorization header
    2. \n
  2. Mind Key ไม่ถูกต้อง (ตรวจว่าขึ้นต้นด้วย mk_)
    3. \n
  3. ใช้ JWT ในที่ที่ต้องใช้ Mind Key (หรือกลับกัน)
    4. \n
  4. Mind Key ถูกเพิกถอน
    5. \n
\n

วิธีแก้: ตรวจสอบ token ของคุณ ดู Authentication

\n

ทำไมฉันได้ 404 Not Found?

\n

คุณใช้ endpoint path ผิด Synapse มีเพียง path ที่แสดงใน GET /endpoints

\n

วิธีแก้: เรียก GET /endpoints เพื่อดู path ที่ถูกต้องทั้งหมด อย่าเดา

\n

ทำไมฉันได้ 429 Too Many Requests?

\n

คุณใช้ auth ผ่าน ?key= query parameter ซึ่งจำกัดที่ 60/min

\n

วิธีแก้: เปลี่ยนไปใช้ Authorization: Bearer header (ไม่จำกัดอัตรา)

\n

ดู Rate Limits

\n

ฉันจะระบุ endpoint ทั้งหมดได้อย่างไร?

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

ฉันจะหา endpoint ที่เหมาะสมได้อย่างไร?

\n
    \n
  1. ตรวจ GET /endpoints สำหรับรายการ machine-readable
    2. \n
  2. ตรวจ GET /help สำหรับ API docs แบบเต็ม
    3. \n
  3. ดู GET /docs สำหรับระบบเอกสาร
    4. \n
  4. ใช้ GET /openapi.json สำหรับ OpenAPI 3.0 spec
    5. \n
\n

ฉันใช้ GET แทน POST ได้ไหม?

\n

POST endpoint บางตัวมี GET equivalent สำหรับเครื่องมือ URL-only:

\n\n

ตรวจ GET /endpoints สำหรับ GET variant ที่มี

\n

ฉันจัดการ error อย่างไร?

\n

error ทั้งหมดส่งกลับเป็น 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}

ดู Errors & Error Handling

\n

ขีดจำกัดขนาด request body คือเท่าไร?

\n

10 MB สำหรับ payload ที่ใหญ่กว่า (เช่น อัปโหลดไฟล์) ให้ใช้ multipart endpoint

\n

API รองรับ CORS ไหม?

\n

ใช่ ทุก endpoint ส่งกลับ:

\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

ฉันทำ pagination อย่างไร?

\n

ใช้ ?limit= และ ?offset=:

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

Limit เริ่มต้น: 100 สูงสุด: 500

\n

ฉันกรอง memory ตาม category หรือ tag ได้ไหม?

\n

ได้:

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

ฉันค้นหา memory อย่างไร?

\n

สองวิธี:

\n
    \n
  1. FTS5 keyword search: GET /memory/search?q=docker+swarm
    2. \n
  2. Semantic search: GET /memory/semantic-search?q=container+orchestration
    3. \n
\n

ดู FTS5 Search และ Semantic Search

\n

ฉันอัปเดต memory อย่างไร?

\n

POST /memory ด้วย category + key เดิม — 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"}'

ฉันลบ memory อย่างไร?

\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"]}