接口query参数说明
query参数是一个json格式的字符串,是一个对象字符串。
第一级的key包括常用的字段:
- limit、skip:分页查询参数,和关系库一致,格式{key:value},key是limit或者skip,value是实际值。
- sort:类似于关系库的order by参数,格式{key:value},key是需要排序的字段名称,value是1和-1,1表示升序,-1表示降序,可以同时按照多个字段排序。
- filter:类似于关系库的where参数,第一级的key可以是字段名称或者or等特殊参数。
字段名称支持完全匹配和模糊搜索,or表示多个满足多个查询条件其中一个
所有的条件查询都写在filter中,不允许特殊参数出现,请根据自身需求传入适当的参数 - project:需要查询的字段,格式{key:value},key是字段名称,value是1
- withCount:总条数,格式{key:value},key是固定值withCount,value是true,会在响应头加上count字段,对应值为条数
以下是一个具体示例:
json样例:
{
"limit": 30, // 限制返回条目数
"skip": 20, //跳过条目数
"sort": { "age" : -1, "time": 1 }, // 条目排序
"filter": {
"name": "Tom", // 条件过滤
"function": { "regex": "device" }, //模糊搜索, function中包含device的
"$or": [ { "score": { "$gt": 70, "$lt": 90 } }, { "views": { "$gte": 1000 } }] // 逻辑查询,$gt,$lt,$gte分别为大于,小于,大于等于
},
"project": {
"name": 1,
"function": 1
}, // 返回字段
"withCount": true // 是否返回总条目数,为true时,会在响应头加上count字段,对应值为条数
}
最后修改时间: 5 个月前