# คำถามที่พบบ่อยเกี่ยวกับ API
SUMMARY: คำถามทั่วไปเกี่ยวกับ Synapse API — auth, rate limit, การจัดการ error, การค้นพบ endpoint

คำถามที่พบบ่อยเกี่ยวกับ API
คำถามทั่วไปเกี่ยวกับ Synapse API
ฉันยืนยันตัวตนอย่างไร?
สองวิธี:
1. Mind Key (สำหรับ endpoint ข้อมูล): 
2. JWT (สำหรับ endpoint บัญชี): 
หรือผ่าน query parameter (จำกัด 60 req/min): 
ดู Authentication
ความแตกต่างระหว่าง Mind Key และ JWT คืออะไร?
- Mind Key: tenant-scoped, ไม่หมดอายุ, สำหรับข้อมูล memory/chat/tasks
- JWT: user-scoped, หมดอายุ 7 วัน, สำหรับการจัดการบัญชี/mind
ดู Mind Key vs JWT
ทำไมฉันได้ 401 Unauthorized?
สาเหตุทั่วไป:
1. ขาด  header
2. Mind Key ไม่ถูกต้อง (ตรวจว่าขึ้นต้นด้วย )
3. ใช้ JWT ในที่ที่ต้องใช้ Mind Key (หรือกลับกัน)
4. Mind Key ถูกเพิกถอน
วิธีแก้: ตรวจสอบ token ของคุณ ดู Authentication
ทำไมฉันได้ 404 Not Found?
คุณใช้ endpoint path ผิด Synapse มีเพียง path ที่แสดงใน 
วิธีแก้: เรียก  เพื่อดู path ที่ถูกต้องทั้งหมด อย่าเดา
ทำไมฉันได้ 429 Too Many Requests?
คุณใช้ auth ผ่าน  query parameter ซึ่งจำกัดที่ 60/min
วิธีแก้: เปลี่ยนไปใช้  header (ไม่จำกัดอัตรา)
ดู Rate Limits
ฉันจะระบุ endpoint ทั้งหมดได้อย่างไร?
[CODE BLOCK]
ฉันจะหา endpoint ที่เหมาะสมได้อย่างไร?
1. ตรวจ  สำหรับรายการ machine-readable
2. ตรวจ  สำหรับ API docs แบบเต็ม
3. ดู  สำหรับระบบเอกสาร
4. ใช้  สำหรับ OpenAPI 3.0 spec
ฉันใช้ GET แทน POST ได้ไหม?
POST endpoint บางตัวมี GET equivalent สำหรับเครื่องมือ URL-only:
-  ↔ 
-  ↔ 
-  ↔ 
ตรวจ  สำหรับ GET variant ที่มี
ฉันจัดการ error อย่างไร?
error ทั้งหมดส่งกลับเป็น JSON:
[CODE BLOCK]
ดู Errors & Error Handling
ขีดจำกัดขนาด request body คือเท่าไร?
10 MB สำหรับ payload ที่ใหญ่กว่า (เช่น อัปโหลดไฟล์) ให้ใช้ multipart endpoint
API รองรับ CORS ไหม?
ใช่ ทุก endpoint ส่งกลับ:
[CODE BLOCK]
มี SDK ไหม?
มี:
- Node.js: 
- MCP: 
ดูรายละเอียดที่ API Overview
ฉันทำ pagination อย่างไร?
ใช้  และ :
[CODE BLOCK]
Limit เริ่มต้น: 100 สูงสุด: 500
ฉันกรอง memory ตาม category หรือ tag ได้ไหม?
ได้:
[CODE BLOCK]
ฉันค้นหา memory อย่างไร?
สองวิธี:
1. FTS5 keyword search: 
2. Semantic search: 
ดู FTS5 Search และ Semantic Search
ฉันอัปเดต memory อย่างไร?
POST  ด้วย  +  เดิม — memory ที่มีอยู่จะถูกอัปเดต ไม่ซ้ำ
[CODE BLOCK]
ฉันลบ memory อย่างไร?
[CODE BLOCK]
ลบเป็นจำนวนมากได้ไหม?
ได้:
[CODE BLOCK]
ขั้นตอนถัดไป
- API Overview
- Errors & Error Handling
- Authentication