文档首页/ 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}/{recordId}?fields={f1,f2}

表1 路径参数

参数

是否必选

参数类型

描述

objectName

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

recordId

是

String

参数解释：

记录ID，可通过调用按条件查询对象数据接口查看（响应消息中的“id”）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值 ：

不涉及。

fields

否

Array

参数解释：

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

约束限制：

不涉及。

请求参数

无

响应参数

表2 响应参数说明

参数

参数类型

描述

resCode

String

参数解释：

返回码。

取值范围：

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

resMsg

String

参数解释：

返回消息。

取值范围：

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

result

Array

参数解释：

如果请求成功，数组中只有一个对象，对象中包含记录中的数据。

请求示例

查询一个记录，例如获取“TestProject__testForObject__CST”对象中，记录ID为“cfw0000000aKin6AQgfQ”的数据。

GET https://AstroZero域名/u-route/baas/data/v1.0/bobject/TestProject__testForObject__CST/cfw0000000aKin6AQgfQ

响应示例

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

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块

相关文档