用途:在 Python、Go、PHP、C#、Rust、Ruby、Java 等缺少 Bmob SDK 的语言环境中,通过纯 HTTP/curl 访问 Bmob 后端云,适用于后端服务、数据迁移脚本、Bash 单行命令、Deno Edge Functions、Serverless 函数等。
主要能力:接口基址为 https://api.codenow.cn/1/(以控制台配置的 API 域名为准),保留版本号。支持对 /1/classes/<TableName> 的增删改查、/1/batch 批量操作(每请求最多 50 条)、/1/cloudQuery 的 BQL 查询、/1/users 注册与 /1/login 登录、/2/files/<fileName> 文件上传、/1/timestamp 服务器时间,并支持 Pointer、Relation、Date、File、GeoPoint 等特殊数据类型(以 __type 字段标识)及原子计数器(__op Increment)。
使用方式:POST/PUT 必须使用 Content-Type: application/json 且 body 为 JSON,不支持 form-urlencoded;GET 的 where、order、limit、skip、include、keys、count 需通过 query string 传递并 URL encode;默认查询返回 10 条,最大 1000,更多需 skip+limit 分页或用 count=1。鉴权有两种:简易授权使用 X-Bmob-Application-Id 与 X-Bmob-REST-API-Key 头部;加密授权使用 6 个头部加 MD5 签名,公式为 sign = md5(url + timeStamp + SecurityCode + noncestr + body + SDKVersion)。登录须用 GET 请求,参数走 query。
限制与安全:批量接口单次最多 50 个子请求且不会回滚;Master Key 通过 X-Bmob-Master-Key 头部使用,仅限服务端;服务端 Key 应放入环境变量;生产环境必须用 HTTPS,否则头部 Key 明文传输;写操作表需配置 ACL,创建对象时在 body 中加入 "ACL" 字段。常见错误包括 401 鉴权失败、400/101 对象不存在或密码错误、400/107 JSON 或 Content-Type 错误、400/10076 QPS 超限等。若配置了 Bmob MCP,可优先调用 generate_code 生成 curl。