文档首页> Astro轻应用 AstroZero> API参考> API> 数据模块> 按条件查询对象记录数
更新时间:2024-04-25 GMT+08:00
分享

按条件查询对象记录数

功能介绍

按条件查询对象记录数。

URI

POST AstroZero域名/u-route/baas/data/v1.0/count/{objectName}

表1 路径参数

参数

是否必选

描述

objectName

数据对象的名称。

base

查询参数,区分传入数据样式,支持选项如下:
  • L:传入的数据ID。
  • N:传入对象名称。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

condition

Object

表示查询的条件,其中包含以下三个元素,若为空则表示查询所有对象数据。

  • conjunction:表示需要满足的条件个数。
    • AND:表示条件都要满足。
    • OR:表示至少要满足一个条件。
  • conditions:筛选条件的数组。如果参数为空,代表查询所有对象数据,若不为空,其中的每一个元素对象都包含三个字段:
    • field:类型string,字段名称。
    • operator:类型string,操作符。例如,操作符“eq”表示等于,“ne”表示不等于,“gt”表示大于,“lt”表示小于,“ge”表示大于等于,“le”表示小于等于。
    • value:类型string,对比值。
  • relation:数组中包含parents(向上查询)和children(向下查询)两个元素,两者分别对应相应的数组。

    其中,parents包含condition数组和relatedField(关联字段名称)。children包含condition数组和relationName(关联字段名称)。

    condition数组包含:

    • conjunction:取值为AND或OR。
    • conditions:同上conditions参数。
    • relation:同上relation参数。

响应参数

表3 响应参数

参数

参数类型

描述

resCode

String

返回码,如果返回“0”代表请求成功,其他错误码说明请参考错误码

resMsg

String

返回消息,如果成功状态,通常会返回“Success”,其他情况会返回具体的错误信息。

result

Number

返回的记录数。

请求示例

查询“TestProject__testForObject1__CST”对象中,name为“lisi”的记录数。
POST https://AstroZero域名/u-route/baas/data/v1.0/count/TestProject__testForObject1__CST 
  
 {
    "condition": {
        "conjunction": "AND",
        "conditions": [
            {
                "field": "NAME",
                "operator": "eq",
                "value": "lisi"
            }
        ]
    }
}

响应示例

{
    "resCode": "0",
    "resMsg": "成功",
    "result": 8
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品