✨ JSON Storage API

基于 Cloudflare Workers 的高性能 JSON 存储解决方案

📝 API 使用说明

读取数据:   使用 GET 请求访问特定路径

GET /{key}

写入数据:   使用 POST 请求向特定路径提交 JSON 数据

POST /{key}
Content-Type: application/json

{"name": "John", "age": 30}

全量更新:   使用 PUT 请求完全替换指定路径的 JSON 数据

PUT /{key}
Content-Type: application/json

{"name": "John", "age": 31}

部分更新:   使用 PATCH 请求部分更新指定路径的 JSON 数据

PATCH /{key}
Content-Type: application/json

{"age": 31}

删除数据:   使用 DELETE 请求删除指定路径的 JSON 数据

DELETE /{key}

⚠️ 本服务已启用密码保护,写入/更新/删除数据时需要在 JSON 中包含正确的密码字段:

POST /{key}
Content-Type: application/json

{"password": "password", "data": {"name": "John", "age": 30}}
PUT/PATCH /{key}
Content-Type: application/json

{"password": "password", "data": {"name": "John", "age": 31}}
DELETE /{key}
Content-Type: application/json

{"password": "password"}

🚀 功能特性

💡 使用示例

使用 CURL 读取数据:

curl -X GET 'https://json.huarzone.com/demo'

使用 CURL 写入数据:

curl -X POST 'https://json.huarzone.com/demo' \
     -H 'Content-Type: application/json' \
     -d '{"password": "password", "data": {"name": "John", "age": 30}}'

使用 CURL 全量更新:

curl -X PUT 'https://json.huarzone.com/demo' \
     -H 'Content-Type: application/json' \
     -d '{"password": "password", "data": {"name": "John", "age": 31, "email": "john@example.com"}}'

使用 CURL 部分更新:

curl -X PATCH 'https://json.huarzone.com/demo' \
     -H 'Content-Type: application/json' \
     -d '{"password": "password", "data": {"age": 32}}'

使用 CURL 删除数据:

curl -X DELETE 'https://json.huarzone.com/demo' \
     -H 'Content-Type: application/json' \
     -d '{"password": "password"}'

🔍 PUT 与 PATCH 的区别

PUT 请求 - 全量更新,完全替换现有资源:

  • 发送整个资源的完整表示
  • 会覆盖目标资源的所有现有数据
  • 适用于替换整个对象的场景

PATCH 请求 - 部分更新,只修改指定的字段:

  • 只发送需要更改的字段
  • 保留未在请求中提及的现有数据
  • 适用于只需更新少量字段的场景

注意: 本服务仅用于临时数据存储,且数据更新可能存在延迟。