按记录ID查询数据
功能介绍
按记录ID查询数据,该接口为同步接口(同步接口是指调用后,会等待函数执行结束后,才返回结果)。
![](https://support.huaweicloud.com/api-astrozero/public_sys-resources/note_3.0-zh-cn.png)
在此之前需要先创建对象以及相关数据记录。
URI
GET AstroZero域名/u-route/baas/data/v1.0/bobject/{objectName}/{recordId}?fields={f1,f2}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
objectName |
是 |
String |
参数解释: 数据对象的名称,请参考登录应用设计器中操作,进入应用设计器,在 列表中查看。 约束限制: 不涉及。 取值范围: 1~80个字符。 默认取值: 不涉及。 |
recordId |
是 |
String |
参数解释: 记录ID,可通过调用按条件查询对象数据接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值 : 不涉及。 |
fields |
否 |
Array |
参数解释: 对象显示的字段,多个字段则用逗号分隔。如果该字段不为空,则仅返回显示的字段和必要信息(如数据记录拥有者信息和id);为空则返回整个记录数据。 约束限制: 不涉及。 |
请求参数
无
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
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" } ] }
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。