# API Genel Bakış & Temel URL
SUMMARY: Tüm Synapse API uç noktaları, temel URL, kimlik doğrulama desenleri ve yanıt biçimleri bir bakışta.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, no rate limit)
      OR ?key=YOUR_MIND_KEY (query, 60 req/min)
All responses are JSON except /memory/recall (text/plain) and /docs (HTML/text/json)
All 404 responses mean the path does not exist — do NOT guess paths.
GET /endpoints returns machine-readable list of all valid endpoints.

API Genel Bakış & Temel URL
Synapse API, RESTful bir HTTP API'sidir. Tüm uç noktalar JSON döndürür (belirtilenler hariç). Bu sayfa, belirli uç noktalara dalmadan önce bilmeniz gereken temel bilgileri kapsar.
Temel URL
[CODE BLOCK]
Bu dokümantasyondaki tüm yollar bu temel URL'ye göredir. Self-hosted örnekler için kendi URL'nizle değiştirin.
Kimlik Doğrulama
İki yöntem, ikisi de  başlığı üzerinden gönderilir:
[CODE BLOCK]
Veya sorgu parametresi üzerinden (60/dakika hız sınırıyla):
[CODE BLOCK]
Detaylar için bkz. Kimlik Doğrulama.
Uç Nokta Grupları
| Grup | Kimlik Doğrulama | Açıklama |
|-------|------|-------------|
| Public | Yok | Açılış sayfası, sağlık, OpenAPI, docs |
| Memory | Mind Key | CRUD, arama, senkronizasyon, gömmeler |
| Chat | Mind Key / JWT | İnsan ve ajan arasında asenkron mesajlaşma |
| Tasks | Mind Key | Görev yönetimi |
| Scripts | Mind Key / JWT | Kalıcı betik deposu |
| Scheduler | Mind Key | Cron işleri + değişkenler |
| Webhooks | Mind Key | Olaylarda HTTP geri aramaları |
| Computers | Mind Key / JWT | Uzak bilgisayar kontrolü |
| User/Minds | JWT | Hesap + mind yönetimi |
| Sharing | JWT | Kullanıcılar arası mind paylaşımı |
| Push | JWT | Web Push abonelikleri |
| Tools | Yok | Saat, hesap, rastgele (herkese açık yardımcılar) |
Yanıt Biçimleri
- JSON (varsayılan): 
- Düz metin: , LLM için optimize edilmiş metin döndürür
- HTML: , , , , 
Standart Yanıt Zarfı
Başarılı yanıtlar veriyi doğrudan döndürür:
[CODE BLOCK]
Hata yanıtları şu biçimi kullanır:
[CODE BLOCK]
> [!NOTE]
>  alanı, yaygın hatalar için ilgili dokümantasyona bağlantı verir.
HTTP Durum Kodları
| Kod | Anlamı |
|------|---------|
| 200 | Başarılı (GET, PUT) |
| 201 | Oluşturuldu (POST) |
| 204 | İçerik yok (DELETE) |
| 400 | Hatalı istek (doğrulama hatası) |
| 401 | Yetkisiz (eksik/geçersiz token) |
| 403 | Yasak (yanlış token tipi) |
| 404 | Bulunamadı (yol mevcut değil) |
| 409 | Çakışma (yinelenen) |
| 429 | Çok fazla istek (hız sınırı) |
| 500 | Sunucu hatası |
Keşfedilebilirlik Uç Noktaları
| Uç Nokta | Amaç |
|----------|---------|
|  | Açılış sayfası (LLM için optimize edilmiş) |
|  | Tüm uç noktaların makine tarafından okunabilir listesi |
|  | Düz metin uç nokta listesi |
|  | OpenAPI 3.0 belirtimi |
|  | Tam API dokümantasyonu (HTML) |
|  | JSON olarak API docs |
|  | Dokümantasyon sistemi (HTML) |
|  | Dokümantasyon dizini (JSON) |
|  | Tüm docs tek metin bloğu olarak |
|  | Etkileşimli API playground |
Hız Sınırları
| Kimlik Doğrulama Yöntemi | Sınır |
|-------------|-------|
| Mind Key (header) | Yok |
| Mind Key (?key=) | IP başına 60/dakika |
| JWT (header) | Yok |
| Herkese açık uç noktalar | Yok |
Hız sınırına takılan yanıtlar şunları içerir:
[CODE BLOCK]
Sayfalama
Liste uç noktaları  ve  destekler:
[CODE BLOCK]
Varsayılan sınır: 100. Maksimum sınır: 500.
CORS
Tüm uç noktalar tarayıcı tabanlı istemciler için CORS'u destekler:
[CODE BLOCK]
SDK'lar & İstemciler
- Node.js SDK:  (repo)
- MCP Server:  (repo)
- HTTP istemcisi: herhangi bir HTTP kütüphanesi (curl, fetch, axios vb.)
Sonraki Adımlar
- Memory API — en önemli uç noktalar
- Chat API — asenkron insan-ajan iletişimi
- Hatalar & Hata Yönetimi