API 文档

🔐 基础认证

所有请求必须携带你的 API 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":"程序员"}