Variables API

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

نقاط النهاية

POST /var

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

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

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

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

الاستجابة:

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

GET /var

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

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

DELETE /var/:key

حذف متغير.

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

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

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

تتبع آخر جلسة

# عند نهاية الجلسة
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# عند بدء الجلسة
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)

نمط العدّاد

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

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

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

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

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

• Memory API — للبيانات المنظمة القابلة للبحث
• Cron والمجدول