{"title":"Variables API","slug":"variables","category":"api","summary":"LLM durumu için hızlı anahtar-değer deposu — sayaçlar, bayraklar, son görülme zaman damgaları, kısmi ilerleme.","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":174,"read_minutes":1,"llm_context":"Auth: Mind Key\nSet: POST /var { key, value }\nGet: GET /var/:key\nList: GET /var\nDelete: DELETE /var/:key\nUse case: store last-seen timestamps, counters, flags, partial workflow state\nFaster than memory (PostgreSQL direct, no FTS5 indexing)\nNot for: structured facts (use /memory), long content (use /script)\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Variables API\n\nVariables 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.\n\n## Uç Noktalar\n\n### POST /var\n\nBir değişken ayarla veya güncelle.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/var \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\"}'\n```\n\n### GET /var/:key\n\nTek bir değişkeni al.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\nYanıt:\n\n```json\n{ \"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\", \"updated_at\": \"...\" }\n```\n\n### GET /var\n\nTüm değişkenleri listele.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var\n```\n\n### DELETE /var/:key\n\nBir değişkeni sil.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\n## Ne Zaman Değişken, Ne Zaman Bellek Kullanılır\n\n| Kullanım Senaryosu | Kullan |\n|----------|-----|\n| Kullanıcı adı, tercihler | Bellek (aranabilir, yapılandırılmış) |\n| Son oturum zaman damgası | Değişken (geçici durum) |\n| Sayaç (örn. gönderilen mesajlar) | Değişken (sık güncellemeler) |\n| İş akışı durumu (\"5 adımın 3'ü tamamlandı\") | Değişken (geçici) |\n| Uzun form proje notları | Bellek (tam metin indeksli) |\n| Yeniden kullanılabilir betikler | Betik deposu (adlandırılmış, sürümlü) |\n\n## Yaygın Desenler\n\n### Son oturumu izle\n\n```bash\n# At session end\ncurl -X POST .../var -d '{\"key\": \"last_session_at\", \"value\": \"'$(date -Iseconds)'\"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d \"$LAST\" +%s)\n```\n\n### Sayaç deseni\n\n```bash\n# Increment\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"api_calls\\\", \\\"value\\\": $((N+1))}\"\n```\n\n### Özellik bayrakları\n\n```bash\ncurl -X POST .../var -d '{\"key\": \"feature_x_enabled\", \"value\": \"true\"}'\n\n# Check\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ \"$ENABLED\" = \"true\" ]; then ... fi\n```\n\n## Sonraki Adımlar\n\n- [Memory API](/docs/api/memory) — yapılandırılmış, aranabilir veriler için\n- [Cron & Zamanlayıcı](/docs/api/cron)\n","content_html":"

Variables API

\n

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.

\n

Uç Noktalar

\n

POST /var

\n

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

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

GET /var/:key

\n

Tek bir değişkeni al.

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

Yanıt:

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

GET /var

\n

Tüm değişkenleri listele.

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

DELETE /var/:key

\n

Bir değişkeni sil.

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

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Kullanım SenaryosuKullan
Kullanıcı adı, tercihlerBellek (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 betiklerBetik deposu (adlandırılmış, sürümlü)
\n

Yaygın Desenler

\n

Son oturumu izle

\n
# At session end\ncurl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d "$LAST" +%s)

Sayaç deseni

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

Özellik bayrakları

\n
curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'\n\n# Check\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ "$ENABLED" = "true" ]; then ... fi

Sonraki Adımlar

\n\n","urls":{"html":"/docs/api/variables","text":"/docs/api/variables?format=text","json":"/docs/api/variables?format=json","llm":"/docs/api/variables?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}