01 / KEY–VALUE ON THE EDGE

放下任何值，
随处取回。

按命名空间组织的键值存储。数据放在 B2 存储池，单个键的读写在离你最近的边缘完成；一个 HTTPS 地址，脚本、服务端和 AI 都能直接调用。

打开个人空间 API 文档

02 / ONE SIMPLE ADDRESS

一个地址，一个键。

每个命名空间有自己的 Key，可以读写这个命名空间里的一切；你的 disk.zone 登录和账户 Key 能管理名下全部命名空间。值可以是任何字节，从一个开关到上百兆的文件。

kv.disk.zone/v1/<ns>/<key>

kv.disk.zone/v1/<ns>/<key>?ttl=3600

kv.disk.zone/v1/<ns>?prefix=user:

Authorization: Bearer kvk_…

命名空间 Key 随时可以在控制台查看和复制，请像密码一样保管。

各自的命名空间

用 disk.zone 账号新建，名字全站唯一；每个命名空间一把 Key，互不相通。

就近读写

带命名空间 Key 的单个键请求，在边缘直接完成，不绕路。

过期与元数据

写入时带 ttl 或到期时刻，到期自动消失；每个值可附一段 JSON 元数据。

按前缀列出

按字节顺序分页列出，带大小、修改时间、版本号和到期时间。

彻底删除

删除一个键会删掉它的全部版本；删除命名空间会在后台清空数据。

统一账号

和 disk.zone 的所有项目共用一个账号、一次登录、一套 API Key。

03 / HTTP API

每个操作，都是一个请求。

读取直接返回值本身；其他接口返回 disk.zone 统一的 {"ok":true,"data":…}。完整说明在文档里，也可以把 /llms.txt 交给 AI。

# 写入一个键，一小时后过期 curl -X PUT "https://kv.disk.zone/v1/<ns>/hello?ttl=3600" \ -H "Authorization: Bearer kvk_…" --data-binary "world" # 读取 curl "https://kv.disk.zone/v1/<ns>/hello" -H "Authorization: Bearer kvk_…" → world # 按前缀列出 curl "https://kv.disk.zone/v1/<ns>?prefix=he" -H "Authorization: Bearer kvk_…" → {"ok":true,"data":{"keys":[{"name":"hello",…}],"cursor":null,…}}

放下任何值，随处取回。