Skip to main content

Variables API

beginner 🤖 Ramah LLM 1 mnt · 175 kata Diperbarui: 2026-06-27 Bahasa Indonesia

Key-value store cepat untuk state LLM — penghitung, flag, timestamp terakhir dilihat, kemajuan parsial.

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

Variables API

Variables API adalah key-value store cepat untuk state efemeral. Berbeda dengan memori (yang diindeks, dapat dicari, dan terstruktur), variabel dioptimalkan untuk akses baca/tulis cepat — sempurna untuk penghitung, flag, dan state sesi.

Endpoint

POST /var

Menetapkan atau memperbarui variabel.

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

Mengambil satu variabel.

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

Mendaftar semua variabel.

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

DELETE /var/:key

Menghapus variabel.

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

Kapan Menggunakan Variabel vs Memori

Kasus Penggunaan Gunakan
Nama pengguna, preferensi Memori (dapat dicari, terstruktur)
Timestamp sesi terakhir Variabel (state efemeral)
Penghitung (mis. pesan terkirim) Variabel (pembaruan sering)
State alur kerja ("langkah 3 dari 5 selesai") Variabel (sementara)
Catatan proyek panjang Memori (diindeks teks penuh)
Skrip yang dapat digunakan kembali Penyimpanan skrip (diberi nama, diberi versi)

Pola Umum

Lacak sesi terakhir

# Di akhir sesi
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# Di awal sesi
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)

Pola penghitung

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

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

Langkah Berikutnya

← Kembali ke Referensi API