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

按条件查询对象记录数

功能介绍

按条件查询对象记录数。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

objectName

String

参数解释

数据对象的名称,请参考登录应用设计器中操作,进入应用设计器,在数据 > 对象列表中查看。

约束限制

不涉及。

取值范围

1~80个字符。

默认取值

不涉及。

base

String

参数解释

查询参数,用于区分objectName传入数据样式。

约束限制

不涉及。

取值范围

支持如下选项:

  • I:对应对象的ID。
  • N:传入的对象名称。

默认取值

不涉及。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

condition

Object

参数解释

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

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

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

约束限制

不涉及。

响应参数

表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
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档