bmob-database-restfullisted
Install: claude install-skill bmob/agent-skills
# Bmob Database — REST API
Bmob REST API 是 **跨语言、跨平台** 的通用接入方式:任何能发 HTTP 请求的环境都能用,不依赖任何 SDK。典型用法包括 Python/Go/PHP/C#/Rust/Ruby/Java 后端、数据迁移脚本、Bash one-liner、Deno Edge Functions、Serverless 函数等。
## 核心原则
**1. URL 形态固定:** 所有接口在 `https://api.codenow.cn/1/`(Bmob 控制台 → 应用 → 设置 → 配置 中显示的 API 域名,一般为 `api.codenow.cn`)。版本号 `/1/` 必须保留。
示例:`https://api.codenow.cn/1/classes/Token` — 对 `Token` 表做 CRUD 时路径即 `/1/classes/Token`。
```
POST /1/classes/<TableName> # 新增
GET /1/classes/<TableName>/<objectId> # 查单条
GET /1/classes/<TableName> # 查列表 / 条件查询
PUT /1/classes/<TableName>/<objectId> # 更新
DELETE /1/classes/<TableName>/<objectId> # 删除
POST /1/batch # 批量(≤ 50 条)
GET /1/cloudQuery # BQL 查询
POST /1/users # 注册
POST /1/login # 登录
POST /2/files/<fileName> # 上传文件
GET /1/timestamp # 服务器时间
```
完整快速参考见 [`references/url-cheatsheet.md`](references/url-cheatsheet.md)。
**2. 两种鉴权方式,均可用**(与 hydrogen-js-sdk **3.0+** 的两种 `Bmob.initialize` 对应):
- **简易授权 — Application ID + REST API Key**(REST 原生方式;JS SDK **方式 B** 即走此通道):Header `X-Bmob-Application-Id` + `X-Bmob-REST-API-Key`。适合服务端、内网脚本、与 SDK 方式 B 共用同一套 Key 的项目。详见 [shared/auth-headers.md](../../shared/auth-headers.md)。
- **加密授权 — Secret Key + API 安全码签名**(JS SDK **方式 A** 走此通道;也可手写 REST):6 个头部 + MD5 签名。适合浏览器 / 小程序直接调 REST、且不想在 Header 里暴露 REST API Key 的场景。详见 [shared