Kullanıcı & Minds API

beginner 🤖 LLM uyumlu 1 dk · 272 kelime Güncellendi: 2026-06-27 Türkçe

Hesap yönetimi — kayıt olma, giriş, mind oluşturma, mind listeleme, mind silme. JWT korumalı.

Bu makaleyi şu şekilde oku: 📄 Düz metin ⚡ JSON 🤖 LLM biçimi

Kullanıcı & Minds API

User & Minds API, hesap yönetimini ele alır. Bu uç noktalar hesap düzeyinde çalıştıkları için (mind düzeyinde değil) JWT kimlik doğrulaması (Mind Key değil) kullanır.

Kimlik Doğrulama Uç Noktaları

POST /register

Yeni bir kullanıcı hesabı oluştur.

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password",
    "display_name": "Michael"
  }'

Yanıt:

{
  "jwt": "eyJhbGci...",
  "user": {
    "id": "u_abc123",
    "email": "you@example.com",
    "display_name": "Michael",
    "created_at": "2026-06-27T..."
  }
}

POST /login

Mevcut bir hesaba giriş yap.

curl -X POST https://synapse.schaefer.zone/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

Yanıt: /register ile aynı.

Minds Uç Noktaları

POST /minds

Yeni bir mind oluştur. Mind Key'i döndürür — hemen kaydedin, yalnızca bir kez gösterilir.

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Work Mind",
    "description": "Job-related memories"
  }'

Yanıt:

{
  "id": "m_xyz789",
  "name": "Work Mind",
  "description": "Job-related memories",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}

`mind_key` yalnızca bir kez gösterilir. Kaybederseniz geri alamazsınız — mind'i silip yenisini oluşturmanız gerekir (bu, saklanan tüm bellekleri kaybeder).

GET /minds

Mevcut kullanıcı için tüm mind'leri listele.

curl -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds

Yanıt:

{
  "minds": [
    {
      "id": "m_xyz789",
      "name": "Work Mind",
      "description": "Job-related memories",
      "created_at": "2026-06-27T...",
      "memory_count": 142,
      "last_activity": "2026-06-27T..."
    }
  ]
}

DELETE /minds/:id

Bir mind'i kalıcı olarak sil.

curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds/m_xyz789

Bir mind'i silmek **geri alınamaz**. Bu mind'deki tüm bellekler, görevler, sohbet geçmişi ve betikler kalıcı olarak kaybolur. Yedekleme gerekiyorsa önce `GET /memory/mind-export` ile dışa aktarın.

Çoklu Mind Deseni

Çoğu kullanıcı bağlamları izole tutmak için birden çok mind'den yararlanır:

# Create minds for different contexts
curl -X POST .../minds -d '{"name": "work", "description": "Job"}'
# → mind_key: mk_work...

curl -X POST .../minds -d '{"name": "personal", "description": "Personal life"}'
# → mind_key: mk_personal...

curl -X POST .../minds -d '{"name": "project-synapse", "description": "Synapse dev"}'
# → mind_key: mk_synapse...

Bağlamları izole tutmak için farklı LLM oturumlarında farklı Mind Key'ler kullanın.

Hesap Güvenliği

Parola gereksinimleri

En az 6 karakter
Maksimum yok (bir parola yöneticisi kullanın)
bcrypt hash olarak saklanır (asla düz metin)

JWT son kullanma

JWT'ler 7 gün sonra sona erer. Sona erdiğinde, tekrar /login çağırın.

Mind Key güvenliği

Mind Key'ler asla sona ermez. Bir Mind Key tehlikeye girerse:

POST /minds ile yeni bir mind oluştur
LLM yapılandırmanızı yeni Mind Key ile güncelle
Tehlikeye giren mind'i DELETE /minds/:id ile sil

Sonraki Adımlar

Kimlik Doğrulama — tam kimlik doğrulama rehberi
Mind Key ve JWT — karar rehberi
Sharing API — mind'leri diğer kullanıcılarla paylaş