# FAQ API
SUMMARY: Pertanyaan API umum — autentikasi, rate limits, penanganan error, penemuan endpoint.

FAQ API
Pertanyaan umum tentang API Synapse.
Bagaimana cara saya melakukan autentikasi?
Dua metode:
1. Mind Key (untuk endpoint data): 
2. JWT (untuk endpoint akun): 
Atau melalui parameter query (batas 60 req/menit): 
Lihat Autentikasi.
Apa perbedaan antara Mind Key dan JWT?
- Mind Key: cakupan tenant, tidak pernah kedaluwarsa, untuk data memori/chat/tugas
- JWT: cakupan pengguna, kedaluwarsa 7 hari, untuk manajemen akun/mind
Lihat Mind Key vs JWT.
Mengapa saya mendapat 401 Unauthorized?
Penyebab umum:
1. Header  tidak ada
2. Mind Key tidak valid (verifikasi dimulai dengan )
3. Menggunakan JWT di mana Mind Key diperlukan (atau sebaliknya)
4. Mind Key telah dicabut
Perbaikan: Verifikasi token Anda. Lihat Autentikasi.
Mengapa saya mendapat 404 Not Found?
Anda menggunakan path endpoint yang salah. Synapse hanya memiliki path yang
tercantum di .
Perbaikan: Panggil  untuk melihat semua path yang valid. Jangan menebak.
Mengapa saya mendapat 429 Too Many Requests?
Anda menggunakan autentikasi parameter query , yang di-rate-limit ke 60/menit.
Perbaikan: Beralih ke header  (tanpa rate limit).
Lihat Rate Limits.
Bagaimana cara mendaftar semua endpoint?
[CODE BLOCK]
Bagaimana cara menemukan endpoint yang tepat?
1. Periksa  untuk daftar yang dapat dibaca mesin
2. Periksa  untuk dokumentasi API lengkap
3. Telusuri  untuk sistem dokumentasi
4. Gunakan  untuk spesifikasi OpenAPI 3.0
Bisakah saya menggunakan GET alih-alih POST?
Beberapa endpoint POST memiliki padanan GET untuk alat yang hanya menggunakan URL:
-  ↔ 
-  ↔ 
-  ↔ 
Periksa  untuk varian GET yang tersedia.
Bagaimana cara saya menangani error?
Semua error mengembalikan JSON:
[CODE BLOCK]
Lihat Errors & Error Handling.
Berapa batas body permintaan?
10 MB. Untuk payload yang lebih besar (mis. unggahan file), gunakan endpoint multipart.
Apakah API mendukung CORS?
Ya. Semua endpoint mengembalikan:
[CODE BLOCK]
Apakah ada SDK?
Ya:
- Node.js: 
- MCP: 
Lihat Ikhtisar API untuk detail.
Bagaimana cara melakukan paginasi?
Gunakan  dan :
[CODE BLOCK]
Limit default: 100. Maksimum: 500.
Bisakah saya memfilter memori berdasarkan kategori atau tag?
Ya:
[CODE BLOCK]
Bagaimana cara mencari memori?
Dua cara:
1. Pencarian kata kunci FTS5: 
2. Pencarian semantik: 
Lihat Pencarian FTS5 dan Pencarian Semantik.
Bagaimana cara memperbarui memori?
POST  dengan  +  yang sama — memori yang ada
diperbarui, tidak diduplikasi.
[CODE BLOCK]
Bagaimana cara menghapus memori?
[CODE BLOCK]
Bisakah saya menghapus secara massal?
Ya:
[CODE BLOCK]
Langkah Berikutnya
- Ikhtisar API
- Errors & Error Handling
- Autentikasi