批量写入 API - 概述

批量写入API允许插入、更新或维护大量数据。这是一个异步API，意味着您的请求响应不是立即可用的。当处理这些记录时，系统会在回调URL中通知您任务完成，或者您可以定期检查任务状态
这个API允许您在一个API调用中插入、更新或维护最多25000记录。

操作步骤

第一步：准备CSV文件

批量写入API只接受压缩到ZIP文件中的CSV文件。
CSV文件中的第一行应该是字段API名称。随后的每一行对应于Zoho CRM中的一条记录。CSV文件可以包含多个记录。CSV文件中的所有记录必须针对同一个模块。下面是一个示例CSV文件，用于在线索模块中插入记录。
参考限制了解CSV文件的限制。

第二步：上传您的文件

作为压缩zip文件上传您的CSV文件与所需的数据。响应包含file_id。在进行批量写入请求时使用此ID。
参考上传文件了解如何上传CSV文件。

第三步：创建批量写入任务

使用file_id(来自上传API)、回调URL、操作类型(插入、更新或更新插入)、模块和相关字段及其字段映射创建(或生成)POST API调用。它将创建一个异步作业并返回一个“ID”，这是您的请求引用。
参考创建批量写入任务了解更多信息。

第四步：检查任务状态

系统会以指定的“回调URL”通知您任务完成。 若要在任务完成之前检查任务的状态，请使用任务的“ID”调用GET API。
参考获取批量写入任务明细了解更多。

第五步：下载结果

在任务成功完成后，在任务详细信息的“result”属性中可以找到“download_url”。调用download_url下载结果。下载的文件将是ZIP文件中的CSV格式，并包含上传文件的前三个映射列，以及另外三个列—ID、Status和Error。
参考下载结果了解更多。