高级查询（分页、排序、比较）

POST

https://api.t1y.net/v5/classes/TableName/query

责任人：王华

高级查询可以使用条件操作符，更好的过滤结果。

(or) 或 - or (>) 大于 -gt
(<) 小于 - lt (>=) 大于等于 -gte
(<= ) 小于等于 - lte 不等于 -ne
存在 - exists -> true 不存在 -exists -> false
包含 - in 不包含 -nin
模糊查询 $regex -> 正则表达式
模糊查询稍复杂一点，比如查询首字母包含 a 的：{"name": "/a/"} 等同于 like '%a%'

首字母是 pa 的：{"name": "/^pa/"}

也可以使用 $regex 正则匹配

例如查询第一页，每页 10 条数据，以年龄进行降序排序（-1 为降序，1 为升序），并且年龄大于 20 岁的：

请求参数

Header 参数

X-T1Y-Application-ID

number

可选

示例值:

X-T1Y-Api-Key

string

可选

示例值:

X-T1Y-Safe-NonceStr

string

可选

示例值:

X-T1Y-Safe-Timestamp

integer

可选

示例值:

X-T1Y-Safe-Sign

string

可选

示例值:

Body 参数application/json

object {0}

示例

{
  "page": 1,
  "size": 10,
  "sort": {
    "age": -1
  },
  "body": {
    "age": {
      "$gt": 20
    }
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.t1y.net/v5/classes/TableName/query' \
--header 'X-T1Y-Application-ID: {{app_id}}' \
--header 'X-T1Y-Api-Key: {{api_key}}' \
--header 'X-T1Y-Safe-NonceStr: {{nonceStr}}' \
--header 'X-T1Y-Safe-Timestamp: {{timestamp}}' \
--header 'X-T1Y-Safe-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{"page": 1, "size": 10, "sort": {"age": -1}, "body": {"age": {"$gt": 20}}}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例异常示例

{
  "code": 200,
  "message": "ok",
  "data": [
    {
      "_id": "65435f093b239fddbc3f646e"
      "name": "王华华",
      "age": 23,
      "sex": "女",
      "createdAt": "2023-11-04T09:25:24.707+08:00",
      "updatedAt": "2023-11-04T09:25:24.707+08:00"
    },
    {
      "_id": "65435f093b239fddbc3f646e"
      "name": "王华",
      "age": 21,
      "sex": "男",
      "createdAt": "2023-11-04T09:25:24.707+08:00",
      "updatedAt": "2023-11-04T09:25:24.707+08:00"
    }
  ]
}

修改于 2023-11-05 01:44:25

批量修改数据

聚合查询（分组、聚合、计算）