文档首页> 应用魔方 AppCube> API参考> API> 数据模块> 按记录ID列表查询数据
更新时间:2022-04-27 GMT+08:00
分享

按记录ID列表查询数据

功能介绍

按记录ID列表查询数据,该接口为同步接口。

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

URI

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

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

objectName

数据对象的名称。

records

记录ID列表,至少有一个记录ID。

fields

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

请求参数

响应参数

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

resCode

String

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

resMsg

String

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

result

Array

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

请求示例

查询两个记录,例如查询“TestProject__testForObject__CST”对象中记录ID为“cfw0000000aKin6AQgfQ”、“cfw0000000aKlMSFn7vk”的数据:
GET https://AppCube域名/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"
        }
]
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

close