# Variables API

Variables API, geçici durum için hızlı bir anahtar-değer deposudur. Belleklerden (indekslenen, aranabilir ve yapılandırılmış) farklı olarak değişkenler hızlı okuma/yazma erişimi için optimize edilmiştir — sayaçlar, bayraklar ve oturum durumu için mükemmeldir.

## Uç Noktalar

### POST /var

Bir değişken ayarla veya güncelle.

```bash
curl -X POST https://synapse.schaefer.zone/var \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "last_session_at", "value": "2026-06-27T14:00:00Z"}'
```

### GET /var/:key

Tek bir değişkeni al.

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var/last_session_at
```

Yanıt:

```json
{ "key": "last_session_at", "value": "2026-06-27T14:00:00Z", "updated_at": "..." }
```

### GET /var

Tüm değişkenleri listele.

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var
```

### DELETE /var/:key

Bir değişkeni sil.

```bash
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var/last_session_at
```

## Ne Zaman Değişken, Ne Zaman Bellek Kullanılır

| Kullanım Senaryosu | Kullan |
|----------|-----|
| Kullanıcı adı, tercihler | Bellek (aranabilir, yapılandırılmış) |
| Son oturum zaman damgası | Değişken (geçici durum) |
| Sayaç (örn. gönderilen mesajlar) | Değişken (sık güncellemeler) |
| İş akışı durumu ("5 adımın 3'ü tamamlandı") | Değişken (geçici) |
| Uzun form proje notları | Bellek (tam metin indeksli) |
| Yeniden kullanılabilir betikler | Betik deposu (adlandırılmış, sürümlü) |

## Yaygın Desenler

### Son oturumu izle

```bash
# At session end
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# At session start
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)
```

### Sayaç deseni

```bash
# Increment
N=$(curl .../var/api_calls | jq -r .value)
curl -X POST .../var -d "{\"key\": \"api_calls\", \"value\": $((N+1))}"
```

### Özellik bayrakları

```bash
curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'

# Check
ENABLED=$(curl .../var/feature_x_enabled | jq -r .value)
if [ "$ENABLED" = "true" ]; then ... fi
```

## Sonraki Adımlar

- [Memory API](/docs/api/memory) — yapılandırılmış, aranabilir veriler için
- [Cron & Zamanlayıcı](/docs/api/cron)