响应和异常

APIResponse、BulkAPIResponse 和 FileAPIResponse 是 Zoho CRM API 的响应的包装器对象。所有 API 调用方法将返回三个对象的其中之一。

• 搜寻实体的方法将返回 APIResponse 对象，搜寻实体列表的方法将返回 BulkAPIResponse 对象。
• 使用实例变量“data”可单独从响应包装器对象中获取实体数据。APIResponse.data 将返回单个 Zoho CRM 实体对象，BulkAPIResponse.data 将返回 Zoho CRM 实体对象列表。
• 对于文件下载 API，将返回 FileAPIResponse，以便从 record.download_photo()、record.download_attachment(attachment_id) 之类的记录或注释中下载照片或附件。

这些响应包装器对象具有以下属性而不是数据：

1. response_headers - 显示当天/窗口的余下 API 计数；以及当前窗口重置的经历时间。
2. info - 实际数据及 API 提供的任何其他信息。
3. bulk_entity_response（EntityResponse 实例的列表） - 批量 API 中的各个实体的状态。例如，插入记录 API 可能因为几个记录而部分失败。此字典给出各个记录的创建状态。

启动应用

每次启用您的应用时，该 SDK 需要调用以下代码行。

应从 python 应用程序的 main 类调用此方法以启动该应用程序。调用它时不应出现任何异常。

检查异常

所有意外行为（例如，故障 API 响应和 SDK 异常）由 SDK 处理，并仅作为单个异常（ZCRMException）抛出。因此，在客户端应用代码中单独捕获此异常已经足够了。