更新数据

生产环境

https://app91651.eapps.dingtalkcloud.com

POST

/hades/open/api/v1/datasheet/data/update

scope:hades:datasheet:update

接口作用

批量更新指定表单的数据记录，单次最多支持100条。更新数据时需包含记录ID。

接口信息

属性	值
URL	`/open/api/v1/datasheet/data/update`
Method	POST
Content-Type	application/json
权限标识	`hades:datasheet:update`

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
dstId	String	是	表单ID
records	List<Map<String, Object>>	是	要更新的数据记录列表（需包含记录ID），最多100条

请求示例:

{
  "corpId": "corp_123456",
  "dstId": "dst_001",
  "records": [
    {
      "recId": "rec_001",
      "fld_001": "张三（已更新）",
      "fld_003": 9500
    },
    {
      "recId": "rec_002",
      "fld_003": 10000
      "fld_001": "张三2",
    }
  ]
}

返回参数

参数名	类型	说明
success	Boolean	是否成功
errorCode	String	错误码
errorMsg	String	错误信息
rid	String	链路追踪ID
data	BatchResponse	批量操作结果

返回示例:

{
	"data":{
		"success":1
	},
	"errorMsg":"成功",
	"success":true
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

示例

{
    "dstId": "dsth6uhsa6a0k7ub23",
    "records": [{
        "fld_text6t894hmna9": "刘德华1-修改",
        "fld_numberev8swsd4kv": 5511,
        "fld_datevzrybwq55r": "2024-06-02",
        "fld_textztwh4wpjlu": "大理1-修改",
        "recId": "rec79xv6c3klvk1j3oybm4q9k9s"
    }],
    "corpId": "ding4c7c311a701851ac35c2f4657eb6378f"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app91651.eapps.dingtalkcloud.com/hades/open/api/v1/datasheet/data/update' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "dstId": "dsth6uhsa6a0k7ub23",
    "records": [{
        "fld_text6t894hmna9": "刘德华1-修改",
        "fld_numberev8swsd4kv": 5511,
        "fld_datevzrybwq55r": "2024-06-02",
        "fld_textztwh4wpjlu": "大理1-修改",
        "recId": "rec79xv6c3klvk1j3oybm4q9k9s"
    }],
    "corpId": "ding4c7c311a701851ac35c2f4657eb6378f"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
	"data":{
		"success":1
	},
	"errorMsg":"成功",
	"success":true
}

修改于 2026-05-22 09:23:06

新增数据

删除数据

更新数据

接口作用#

接口信息#

请求参数#

返回参数#

请求参数

请求示例代码

返回响应

接口作用

接口信息

请求参数

返回参数