Variables API

beginner 🤖 LLM-vriendelijk 1 min · 168 woorden Bijgewerkt: 2026-06-27 Nederlands

Snelle key-value-opslag voor LLM-staat — tellers, vlaggen, laatst-gezien-tijdstempels, gedeeltelijke voortgang.

Lees dit artikel als: 📄 Platte tekst ⚡ JSON 🤖 LLM-formaat

Variables API

De Variables API is een snelle key-value-opslag voor efemere staat. In tegenstelling tot herinneringen (die geïndexeerd, doorzoekbaar en gestructureerd zijn), zijn variabelen geoptimaliseerd voor snelle lees/schrijftoegang — perfect voor tellers, vlaggen en sessiestaat.

Eindpunten

POST /var

Stel een variabele in of werk deze bij.

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

Haal één variabele op.

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

Respons:

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

GET /var

Toon alle variabelen.

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

DELETE /var/:key

Verwijder een variabele.

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

Wanneer variabelen versus memory gebruiken

Gebruik	Gebruik
Gebruikersnaam, voorkeuren	Memory (doorzoekbaar, gestructureerd)
Laatste sessie-tijdstempel	Variable (efemere staat)
Teller (bijv. verzonden berichten)	Variable (veel updates)
Workflow-staat ("stap 3 van 5 klaar")	Variable (tijdelijk)
Lange projectnotities	Memory (volledige-tekst geïndexeerd)
Herbruikbare scripts	Script store (benoemd, van versie voorzien)

Veelvoorkomende patronen

Laatste sessie bijhouden

# Aan einde van sessie
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# Aan begin van sessie
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)

Teller-patroon

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

Feature flags

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

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

Volgende stappen

Memory API — voor gestructureerde, doorzoekbare data
Cron & Scheduler