KV 读写服务

Cloudflare Workers KV 读写接口文档

服务概览

此服务提供通过 GET 请求进行键值对(Key-Value)数据的读取和写入操作。

所有操作均通过URL参数进行,无需认证(生产环境应添加认证机制)。

读取接口

从 KV 存储中读取指定键的值。

端点
/read?key={your_key}
参数 类型 必填 说明
key String 要读取的键名称
成功响应
{
"status": "success",
"key": "username",
"value": "john_doe"
}
失败响应
{
"status": "error",
"message": "Key not found"
}

注意: 如果请求的键不存在,会返回错误消息。

写入接口

向 KV 存储中写入键值对数据。

端点
/write?key={your_key}&value={your_value}
参数 类型 必填 说明
key String 要写入的键名称
value String 要写入的值
成功响应
{
"status": "success",
"key": "theme",
"value": "dark"
}
失败响应
{
"status": "error",
"message": "Failed to write to KV"
}

注意: 此服务将值存储为纯文本,不适合存储敏感信息。