# API SSS
SUMMARY: Yaygın API soruları — kimlik doğrulama, hız sınırları, hata yönetimi, uç nokta keşfi.

API SSS
Synapse API hakkında yaygın sorular.
Nasıl kimlik doğrularım?
İki yöntem:
1. Mind Key (veri uç noktaları için): 
2. JWT (hesap uç noktaları için): 
Veya sorgu parametresi ile (60 istek/dakika sınırı): 
Bkz. Kimlik Doğrulama.
Mind Key ve JWT arasındaki fark nedir?
- Mind Key: kiracı kapsamlı, asla sona ermez, memory/chat/tasks verileri için
- JWT: kullanıcı kapsamlı, 7 günlük son kullanma, hesap/mind yönetimi için
Bkz. Mind Key ve JWT.
Neden 401 Unauthorized alıyorum?
Yaygın nedenler:
1.  başlığı eksik
2. Geçersiz Mind Key ( ile başladığını doğrulayın)
3. Mind Key gerekendiye JWT kullanma (veya tersi)
4. Mind Key iptal edilmiş
Çözüm: Token'ınızı doğrulayın. Bkz. Kimlik Doğrulama.
Neden 404 Not Found alıyorum?
Yanlış bir uç nokta yolu kullandınız. Synapse'te yalnızca  içinde listelenen yollar mevcuttur.
Çözüm: Tüm geçerli yolları görmek için  çağırın. Tahmin etmeyin.
Neden 429 Too Many Requests alıyorum?
 sorgu parametresi kimlik doğrulaması kullanıyorsunuz, bu da 60/dakika ile sınırlıdır.
Çözüm:  başlığına geçin (hız sınırı yok).
Bkz. Hız Sınırları.
Tüm uç noktaları nasıl listelerim?
[CODE BLOCK]
Doğru uç noktayı nasıl bulurum?
1. Makine tarafından okunabilir liste için  kontrol edin
2. Tam API docs için  kontrol edin
3. Dokümantasyon sistemi için  göz atın
4. OpenAPI 3.0 spec için  kullanın
POST yerine GET kullanabilir miyim?
Bazı POST uç noktalarının yalnızca URL kullanan araçlar için GET karşılığı vardır:
-  ↔ 
-  ↔ 
-  ↔ 
Mevcut GET varyantları için  kontrol edin.
Hataları nasıl ele alırım?
Tüm hatalar JSON döndürür:
[CODE BLOCK]
Bkz. Hatalar & Hata Yönetimi.
İstek gövdesi sınırı nedir?
10 MB. Daha büyük yükler için (örn. dosya yüklemeleri) multipart uç noktalarını kullanın.
API CORS destekliyor mu?
Evet. Tüm uç noktalar şunu döndürür:
[CODE BLOCK]
Bir SDK var mı?
Evet:
- Node.js: 
- MCP: 
Detaylar için bkz. API Genel Bakış.
Nasıl sayfalandırırım?
 ve  kullanın:
[CODE BLOCK]
Varsayılan sınır: 100. Maksimum: 500.
Bellekleri kategoriye veya etikete göre filtreleyebilir miyim?
Evet:
[CODE BLOCK]
Bellekleri nasıl ararım?
İki yol:
1. FTS5 anahtar kelime arama: 
2. Anlamsal arama: 
Bkz. FTS5 Arama ve Anlamsal Arama.
Bir belleği nasıl güncellerim?
Aynı  +  ile  — mevcut bellek güncellenir, çoğaltılmaz.
[CODE BLOCK]
Bir belleği nasıl silerim?
[CODE BLOCK]
Toplu silebilir miyim?
Evet:
[CODE BLOCK]
Sonraki Adımlar
- API Genel Bakış
- Hatalar & Hata Yönetimi
- Kimlik Doğrulama