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

按记录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"
        }
]
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档