API 文档
🔐 基础认证
所有请求必须携带你的 API Key,支持以下两种方式(二选一):
- URL 参数:
?api_key=你的Key - Header 请求头:
Authorization: Bearer 你的Key
📦 一、KV 基础模式 (极简键值对)
适合存放配置、短文本、令牌、日记等。无需建表,直接读写。
1. 写入数据 (POST)
POST /write/[name]?api_key=你的Key Body: 你要写入的纯文本
💡 隐藏特性:文本超过 100 字时,后台会自动调用 AI 提炼摘要,并保存在 [name]_summary 键中。
2. 读取数据 (GET)
GET /read/[name]?api_key=你的Key
3. 删除数据 (DELETE)
DELETE /delete/[name]?api_key=你的Key
💻 二、SQL 兼容模式 (关系型建表)
支持标准的 SQLite 语法。系统会自动在底层为你分配专属的物理表前缀,你的数据和别人的数据绝对隔离,不会冲突。
⚠️ 注意:在 SQL 中,必须严格遵守“先建表,后操作”的顺序!
例如你要操作一张名为 notes 的表,底层实际创建的是 u_你的前缀_notes。你只需要在代码里写 notes 即可。
请求方式
POST /query?api_key=你的Key
Content-Type: application/json
Body:
{
"sql": "SELECT * FROM notes WHERE id = 1"
}
支持:CREATE TABLE (建表), INSERT (插入), SELECT (查询), UPDATE (更新), DELETE (删除)。
💡 进阶:用 SQL 跨维查询 KV 数据
系统允许你通过 SQL 语句直接查询你的 KV 数据,底层会自动注入 user_id 隔离条件,绝对安全:
SELECT * FROM kv_store;
⚠️ 安全限制:为了保证 KV 接口的稳定,禁止通过 SQL 执行 INSERT、UPDATE、DELETE 来修改 kv_store 表。修改数据请用标准的 KV 接口。
🤖 三、AI 专属模式
让你的数据库拥有理解能力。直接发送一段自然语言,AI 自动提取字段并转为 JSON 存入数据库。
智能格式化写入 (POST)
POST /ai/format/[name]?api_key=你的Key Body: 我叫张三,今年18岁,是个程序员。
返回并存入:{"name":"张三","age":18,"job":"程序员"}