API 开发者文档

欢迎使用 DataCloud

不要把我们当成复杂的数据库。作为前端或后端开发者，你只需要记住一件事：
“用普通的 HTTP POST 请求，发送一段 JSON，就能完成数据的增删改查。”

🔑 全局准备工作

  • 接口根地址： https://api.datacloud.com/v1/
  • 身份认证： 所有接口都需要在 Header 中携带 Authorization: Bearer 你的Token

基础数据操作 (CRUD)

系统是 Schema-Free（无模式） 的。插入数据时如果表不存在，会自动创建表和字段，无需提前建表。

{{ api.method }}

{{ api.title }}

{{ api.desc }}

Endpoint: {{ api.endpoint }}

高级：原子操作宏 (Macros)

当多个人同时修改一个数据时（比如点赞、扣库存），直接覆盖数据会导致错误。我们提供了 宏指令，让数据库在底层直接进行安全计算。

如果你想实现... 使用这个宏 JSON 传参示例
增加阅读量 / 扣除积分 $INC "views": "$INC(1)"
"score": "$INC(-50)"
更新时间为当前时间 $NOW "updated_at": "$NOW"
往数组里追加标签 $PUSH "tags": { "$PUSH": "VIP" }

// 结合更新接口使用示例：给用户张三增加 100 积分，并刷新更新时间

await fetch('https://api.datacloud.com/v1/data/update', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
  body: JSON.stringify({
    table: 'users',
    where: { name: '张三' },
    data: { 
      score: '$INC(100)',    // 自动在原积分上+100
      updated_at: '$NOW'     // 自动填入当前服务器时间
    }
  })
});

出错了怎么办？

如果接口请求失败，返回的 HTTP 状态码通常不是 200。请对照下表排查：

401 Unauthorized

你的 Token 没传，或者过期了。检查一下 Header 里的 Authorization 拼写对不对。

403 Forbidden

Token 是对的，但你试图操作一个你不拥有的表，或者触发了安全拦截。

400 Bad Request

你传的 JSON 格式不对，少传了 table 名字，或者 where 条件写错了。