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

按记录ID更新数据

功能介绍

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

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

URI

PUT AstroZero域名/u-route/baas/data/v1.0/bobject/{objectName}/{recordId}

表1 路径参数

参数

是否必选

参数类型

描述

objectName

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

recordId

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

setValue

是

Object

参数解释：

更改的属性和新值组成的对象。

约束限制：

不涉及。

响应参数

表3 响应参数

参数

参数类型

描述

resCode

String

参数解释：

返回码。

取值范围：

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

resMsg

String

参数解释：

返回消息。

取值范围：

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

result

Number

参数解释：

更新记录的个数，成功时携带。

取值范围：

数字，一般更新成功为“1”。

请求示例

更新一个记录，例如更新“TestProject__testForObject__CST”对象，记录ID为“cfw0000000aKin6AQgfQ”的数据。 
PUT https://AstroZero域名/u-route/baas/data/v1.0/bobject/TestProject__testForObject__CST/cfw0000000aKin6AQgfQ

{
    "setValue": {
        "name": "newName"
    }
}

响应示例

{
    "resCode": "0",
    "resMsg": "成功",
    "result": 1
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块

相关文档