{"title":"Variables API","slug":"variables","category":"api","summary":"تخزين سريع للقيم الأساسية لحالة LLM — عدّادات، أعلام، طوابع زمنية لآخر مشاهدة، تقدّم جزئي.","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":166,"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":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# Variables API\n\nVariables API تخزين سريع للقيم الأساسية للحالة المؤقتة. على عكس\nالذكريات (المُفهرَسة والقابلة للبحث والمنظمة)، المتغيرات مُحسّنة\nللوصول السريع للقراءة/الكتابة — مثالية للعدّادات والأعلام وحالة\nالجلسة.\n\n## نقاط النهاية\n\n### POST /var\n\nتعيين متغير أو تحديثه.\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\nالحصول على متغير واحد.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\nالاستجابة:\n\n```json\n{ \"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\", \"updated_at\": \"...\" }\n```\n\n### GET /var\n\nقائمة بجميع المتغيرات.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var\n```\n\n### DELETE /var/:key\n\nحذف متغير.\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\n## متى تستخدم المتغيرات مقابل الذاكرة\n\n| حالة الاستخدام | استخدم |\n|----------|-----|\n| اسم المستخدم، التفضيلات | الذاكرة (قابلة للبحث، منظمة) |\n| طابع زمني لآخر جلسة | متغير (حالة مؤقتة) |\n| عدّاد (مثل الرسائل المُرسلة) | متغير (تحديثات متكررة) |\n| حالة سير العمل (\"الخطوة 3 من 5 مكتملة\") | متغير (عابرة) |\n| ملاحظات مشروع طويلة | الذاكرة (مفهرسة بنص كامل) |\n| سكربتات قابلة لإعادة الاستخدام | تخزين السكربتات (مُسمّاة، مُصدَّرة) |\n\n## الأنماط الشائعة\n\n### تتبع آخر جلسة\n\n```bash\n# عند نهاية الجلسة\ncurl -X POST .../var -d '{\"key\": \"last_session_at\", \"value\": \"'$(date -Iseconds)'\"}'\n\n# عند بدء الجلسة\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d \"$LAST\" +%s)\n```\n\n### نمط العدّاد\n\n```bash\n# زيادة\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"api_calls\\\", \\\"value\\\": $((N+1))}\"\n```\n\n### أعلام الميزات\n\n```bash\ncurl -X POST .../var -d '{\"key\": \"feature_x_enabled\", \"value\": \"true\"}'\n\n# تحقق\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ \"$ENABLED\" = \"true\" ]; then ... fi\n```\n\n## الخطوات التالية\n\n- [Memory API](/docs/api/memory) — للبيانات المنظمة القابلة للبحث\n- [Cron والمجدول](/docs/api/cron)\n","content_html":"

Variables API

\n

Variables API تخزين سريع للقيم الأساسية للحالة المؤقتة. على عكس\nالذكريات (المُفهرَسة والقابلة للبحث والمنظمة)، المتغيرات مُحسّنة\nللوصول السريع للقراءة/الكتابة — مثالية للعدّادات والأعلام وحالة\nالجلسة.

\n

نقاط النهاية

\n

POST /var

\n

تعيين متغير أو تحديثه.

\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

الحصول على متغير واحد.

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

الاستجابة:

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

GET /var

\n

قائمة بجميع المتغيرات.

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

DELETE /var/:key

\n

حذف متغير.

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

متى تستخدم المتغيرات مقابل الذاكرة

\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
حالة الاستخداماستخدم
اسم المستخدم، التفضيلاتالذاكرة (قابلة للبحث، منظمة)
طابع زمني لآخر جلسةمتغير (حالة مؤقتة)
عدّاد (مثل الرسائل المُرسلة)متغير (تحديثات متكررة)
حالة سير العمل ("الخطوة 3 من 5 مكتملة")متغير (عابرة)
ملاحظات مشروع طويلةالذاكرة (مفهرسة بنص كامل)
سكربتات قابلة لإعادة الاستخدامتخزين السكربتات (مُسمّاة، مُصدَّرة)
\n

الأنماط الشائعة

\n

تتبع آخر جلسة

\n
# عند نهاية الجلسة\ncurl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'\n\n# عند بدء الجلسة\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d "$LAST" +%s)

نمط العدّاد

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

أعلام الميزات

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

الخطوات التالية

\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"]}