文档首页/ Astro轻应用 AstroZero/ API参考/ API/ 数据模块/ 批量插入或修改对象数据
更新时间：2024-11-21 GMT+08:00
查看PDF
分享

批量插入或修改对象数据

功能介绍

批量插入或修改对象数据，若数据包含id进行更新，若数据不含id进行插入。

URI

POST AstroZero域名/u-route/baas/data/v1.0/upsert/{objectName}

表1 路径参数

参数

是否必选

参数类型

描述

objectName

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

1~80个字符。

默认取值：

不涉及。

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

records

是

Array

参数解释：

需要插入或者更新的数据组成的数组。

约束限制：

若数据中包含id则视为更新，否则视为插入新数据。

响应参数

表3 响应参数

参数

参数类型

描述

resCode

String

参数解释：

返回码。

取值范围：

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

resMsg

String

参数解释：

返回消息。

取值范围：

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

result

Array

参数解释：

插入或者更新成功，返回相应记录id组成的数组。

请求示例

向对象“TestProject__testForObject1__CST”中插入三条数据，body体中含有要插入的records参数。 
POST https://AstroZero域名/u-route/baas/data/v1.0/upsert/TestProject__testForObject1__CST
  
 {
    "records":[
     {
         "name":"zhang",
         "TestProject__length__CST":"17"
     },
     {
         "name":"li",
         "TestProject__length__CST":"30"
     },
     {
         "name":"wang",
         "TestProject__length__CST":"20"
     }
     ]
}

响应示例

{
    "resCode": "0",
    "resMsg": "成功",
    "result": [
        {
            "id": "cglE000000aMFjB9ipAu"
        },
        {
            "id": "cglE000000aMFjB9ipAv"
        },
        {
            "id": "cglE000000aMFjB9ipAw"
        }
    ]
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据模块

相关文档