批量操作
在单个 API 调用中高效执行批量操作。
batch_create
一次创建多个实体。
参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
entity_type | string | 是 | 实体类型 |
data_list | array | 是 | 实体数据对象列表 |
示例
在项目 123 中创建 10 个镜头，命名为 SH001 到 SH010batch_update
一次更新多个实体。
参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
updates | array | 是 | 更新对象列表 |
每个更新对象包含：
entity_type：实体类型entity_id：实体 IDdata：要更新的字段
示例
将镜头 100、101、102 的状态更新为 "fin"batch_delete
一次删除多个实体。
参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
entities | array | 是 | 实体引用列表 |
每个实体引用包含：
entity_type：实体类型entity_id：实体 ID
示例
删除镜头 100、101、102性能优势
批量操作比单个操作快得多：
| 操作 | 单个 | 批量 | 加速比 |
|---|---|---|---|
| 创建 100 个实体 | ~100 次 API 调用 | 1 次 API 调用 | ~100x |
| 更新 50 个实体 | ~50 次 API 调用 | 1 次 API 调用 | ~50x |
| 删除 20 个实体 | ~20 次 API 调用 | 1 次 API 调用 | ~20x |