{"title":"Variables API","slug":"variables","category":"api","summary":"Cửa hàng key-value nhanh cho trạng thái LLM — bộ đếm, cờ, timestamp lần cuối xem, tiến độ từng phần.","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":237,"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":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Variables API\n\nVariables API là một cửa hàng key-value nhanh cho trạng thái tạm thời. Khác với\nbộ nhớ (được đánh chỉ mục, có thể tìm kiếm và có cấu trúc), biến được tối ưu\ncho truy cập đọc/ghi nhanh — hoàn hảo cho bộ đếm, cờ và trạng thái phiên.\n\n## Các endpoint\n\n### POST /var\n\nĐặt hoặc cập nhật một biế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\nLấy một biến đơn lẻ.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\nPhản hồi:\n\n```json\n{ \"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\", \"updated_at\": \"...\" }\n```\n\n### GET /var\n\nLiệt kê tất cả biến.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var\n```\n\n### DELETE /var/:key\n\nXóa một biế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## Khi nào dùng Biến so với Bộ nhớ\n\n| Trường hợp | Sử dụng |\n|----------|-----|\n| Tên người dùng, sở thích | Bộ nhớ (có thể tìm kiếm, có cấu trúc) |\n| Timestamp phiên cuối | Biến (trạng thái tạm thời) |\n| Bộ đếm (ví dụ tin nhắn đã gửi) | Biến (cập nhật thường xuyên) |\n| Trạng thái quy trình (\"đã xong bước 3/5\") | Biến (tạm thời) |\n| Ghi chú dự án dạng dài | Bộ nhớ (đánh chỉ mục toàn văn) |\n| Script tái sử dụng | Cửa hàng script (đặt tên, đánh phiên bản) |\n\n## Mẫu phổ biến\n\n### Theo dõi phiên cuối\n\n```bash\n# At session end\ncurl -X POST .../var -d '{\"key\": \"last_session_at\", \"value\": \"'$(date -Iseconds)'\"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d \"$LAST\" +%s)\n```\n\n### Mẫu bộ đếm\n\n```bash\n# Increment\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"api_calls\\\", \\\"value\\\": $((N+1))}\"\n```\n\n### Cờ tính năng\n\n```bash\ncurl -X POST .../var -d '{\"key\": \"feature_x_enabled\", \"value\": \"true\"}'\n\n# Check\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ \"$ENABLED\" = \"true\" ]; then ... fi\n```\n\n## Bước tiếp theo\n\n- [Memory API](/docs/api/memory) — cho dữ liệu có cấu trúc, có thể tìm kiếm\n- [Cron & Scheduler](/docs/api/cron)\n","content_html":"

Variables API

\n

Variables API là một cửa hàng key-value nhanh cho trạng thái tạm thời. Khác với\nbộ nhớ (được đánh chỉ mục, có thể tìm kiếm và có cấu trúc), biến được tối ưu\ncho truy cập đọc/ghi nhanh — hoàn hảo cho bộ đếm, cờ và trạng thái phiên.

\n

Các endpoint

\n

POST /var

\n

Đặt hoặc cập nhật một biế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

Lấy một biến đơn lẻ.

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

Phản hồi:

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

GET /var

\n

Liệt kê tất cả biến.

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

DELETE /var/:key

\n

Xóa một biến.

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

Khi nào dùng Biến so với Bộ nhớ

\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
Trường hợpSử dụng
Tên người dùng, sở thíchBộ nhớ (có thể tìm kiếm, có cấu trúc)
Timestamp phiên cuốiBiến (trạng thái tạm thời)
Bộ đếm (ví dụ tin nhắn đã gửi)Biến (cập nhật thường xuyên)
Trạng thái quy trình ("đã xong bước 3/5")Biến (tạm thời)
Ghi chú dự án dạng dàiBộ nhớ (đánh chỉ mục toàn văn)
Script tái sử dụngCửa hàng script (đặt tên, đánh phiên bản)
\n

Mẫu phổ biến

\n

Theo dõi phiên cuối

\n
# At session end\ncurl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'\n\n# At session start\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d "$LAST" +%s)

Mẫu bộ đếm

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

Cờ tính năng

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

Bước tiếp theo

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