文档首页/ Astro轻应用 AstroZero/ API参考/ API/ 数据模块/ 按记录ID列表查询数据
更新时间：2024-07-18 GMT+08:00
查看PDF
分享

按记录ID列表查询数据

功能介绍

按记录ID列表查询数据，该接口为同步接口（同步接口是指调用后，会等待函数执行结束后，才返回结果）。

在此之前需要先创建对象以及待查询的数据记录。

URI

GET AstroZero域名/u-route/baas/data/v1.0/bobject/{objectName}?fields={f1,f2}&records={id1,id2}

表1 路径参数

参数

是否必选

参数类型

描述

objectName

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

records

是

Array

参数解释：

记录ID列表，至少有一个记录ID。其中，{id1,id2}可通过调用按条件查询对象数据接口查看（响应消息中的“id”）。

约束限制：

不涉及。

fields

否

Array

参数解释：

对象显示的字段，多个字段用逗号分隔。如果该字段不为空，则仅返回显示的字段和必要信息（如owner信息和id）；为空则返回整个记录字段。

约束限制：

不涉及。

请求参数

无

响应参数

表2 响应参数

参数

参数类型

描述

resCode

String

参数解释：

返回码。

取值范围：

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

resMsg

String

参数解释：

返回消息。

取值范围：

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

result

Array

参数解释：

查询的记录数据所形成的数组。

请求示例

查询两个记录，例如查询“TestProject__testForObject__CST”对象中，记录ID为“cfw0000000aKin6AQgfQ”、“cfw0000000aKlMSFn7vk”的数据。 
GET https://AstroZero域名/u-route/baas/data/v1.0/bobject/TestProject__testForObject__CST?records=cfw0000000aKin6AQgfQ,cfw0000000aKlMSFn7vk

响应示例

{
   "resCode": "0",
    "resMsg": "成功",
    "result": [
        {
            "TestProject__address__CST": null,
            "createdBy": "10gd000000SDzgxNSckK",
            "createdBy.__objectType": "User",
            "createdBy.name": "test",
            "createdDate": "2020-05-28 14:34:40",
            "currencyIsoCode": "",
            "id": "cfw0000000aKin6AQgfQ",
            "installedPackage": null,
            "lastModifiedBy": "10gd000000SDzgxNSckK",
            "lastModifiedBy.__objectType": "User",
            "lastModifiedBy.name": "test",
            "lastModifiedDate": "2020-05-28 15:03:15",
            "name": "newName",
            "owner": "10gd000000SDzgxNSckK",
            "owner.__objectType": "User",
            "owner.name": "test"
        },
        {
            "TestProject__address__CST": null,
            "createdBy": "10gd000000SDzgxNSckK",
            "createdBy.__objectType": "User",
            "createdBy.name": "test",
            "createdDate": "2020-05-28 15:10:38",
            "currencyIsoCode": "",
            "id": "cfw0000000aKlMSFn7vk",
            "installedPackage": null,
            "lastModifiedBy": "10gd000000SDzgxNSckK",
            "lastModifiedBy.__objectType": "User",
            "lastModifiedBy.name": "test",
            "lastModifiedDate": "2020-05-28 15:10:38",
            "name": "test2",
            "owner": "10gd000000SDzgxNSckK",
            "owner.__objectType": "User",
            "owner.name": "test"
        }
]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块

相关文档