Skip to main content

Variables-API

beginner 🤖 LLM-freundlich 1 Min · 160 Wörter Aktualisiert: 2026-06-27 Deutsch

Schneller Key-Value-Store für LLM-Status — Zähler, Flags, Last-Seen-Zeitstempel, teilweiser Fortschritt.

Diesen Artikel lesen als: 📄 Plain Text ⚡ JSON 🤖 LLM-Format
Sprache: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

Variables-API

Die Variables-API ist ein schneller Key-Value-Store für flüchtigen Status. Im Gegensatz zu Memories (die indiziert, durchsuchbar und strukturiert sind) sind Variablen für schnelle Lese-/Schreibzugriffe optimiert — perfekt für Zähler, Flags und Session-Status.

Endpunkte

POST /var

Eine Variable setzen oder aktualisieren.

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

Eine einzelne Variable abrufen.

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

Antwort:

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

GET /var

Alle Variablen auflisten.

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

DELETE /var/:key

Eine Variable löschen.

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

Wann Variablen statt Memory verwenden?

Anwendungsfall Verwende
Nutzername, Präferenzen Memory (durchsuchbar, strukturiert)
Zeitstempel der letzten Session Variable (flüchtiger Status)
Zähler (z. B. gesendete Nachrichten) Variable (häufige Updates)
Workflow-Status („Schritt 3 von 5 erledigt") Variable (vorübergehend)
Ausführliche Projektnotizen Memory (volltextindiziert)
Wiederverwendbare Scripts Script-Speicher (benannt, versioniert)

Häufige Patterns

Letzte Session verfolgen

# 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)

Zähler-Pattern

# Increment
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"}'

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

Nächste Schritte

← Zurück zu API-Referenz