阅读(2613) (0)

微信小程序云开发 API数据库·查询记录

2020-07-24 16:28:24 更新

databaseQuery

本接口应在服务器端调用,详细说明参见服务端API。

数据库查询记录

请求地址

POST https://api.weixin.qq.com/tcb/databasequery?access_token=ACCESS_TOKEN

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
envstring云环境ID
querystring数据库操作语句

返回值

Object

返回的 JSON 数据包

属性类型说明
errcodenumber错误码
errmsgstring错误信息
pagerObject分页信息
dataArray.<string>记录数组

errcode 的合法值

说明最低版本
0请求成功
-1系统错误
-1000系统错误
40014AccessToken 不合法
40097请求参数错误
40101缺少必填参数
41001缺少AccessToken
42001AccessToken过期
43002HTTP METHOD 错误
44002POST BODY 为空
47001POST BODY 格式错误
85088该APP未开通云开发
其他错误码云开发错误码

pager 的结构

属性类型说明
Offsetnumber偏移
Limitnumber单次查询限制
Totalnumber符合查询条件的记录总数

Tips

query中应使用limit()限制单次拉取的数量,默认10条。

请求数据示例

{
  "env":"test2-4a89da",
  "query": "db.collection(\"geo\").where({done:true}).limit(10).skip(1).get()"
}

返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "pager": {
        "Offset": 1,
        "Limit": 10,
        "Total": 2
    },
    "data": [
        "{\"_id\":\"b15498af-1a5a-40b4-a4e7-b3fc4a1df482\",\"done\":true,\"name\":\"test\"}"
    ]
}

数据库操作语句说明

数据库操作语句语法与数据库 API相同