Zoho crm Logo

获取数据备份下载URLs

目的

获取您的Zoho CRM账户中最新定时备份数据的下载URL。这些URL可以用来下载备份的数据和与您的记录相关的附件。

端点

  • GET /备份/网址

Request 详情

Request URL

{api-domain}/crm/bulk/{version}/backup/urls

头部

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.bulk.backup.ALL
(or)
ZohoCRM.bulk.backup.READ

可能的操作类型

ALL - 对备份数据的完全访问
READ - 获取有关计划备份的信息

样本请求

Response JSON 键

  • data_links URL

    包含模块特定数据的计划备份的下载URL,这些数据在单独的CSV文件中,还包括模块元数据和记录图像。
    示例:"https://download-accl.zoho.com/v2/crm/123456789/backup/3652397000001763003/Data_001.zip"
    这里,123456789是您备份的组织的唯一ID (zgid),
    3652397000001763003是备份任务的ID,
    Data_001.zip是文件名。

  • attachment_links URL

    包含所有模块中记录的所有附件的定时备份的下载URL。
    示例:"https://download-accl.zoho.com/v2/crm/123456789/backup/3652397000001763003/Attachments_001.zip"
    这里,123456789是您已备份数据的组织的唯一ID(zgid),
    3652397000001763003是备份任务的ID,
    Attachments_001.zip是文件名。

  • expiry_date DateTime

    备份链接的过期日期,过了这个日期,文件将无法再下载。

注意

当没有可用的下载链接时,系统会以无内容的主体和状态码204进行响应。

Possible Errors

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方案:使用HTTP GET方法来进行此API调用。任何其他请求方法都会导致此错误。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成具有此API所需范围的新访问令牌。请参阅此页面开头的范围部分,以获取所需范围的列表。

  • NO_PERMISSIONHTTP 403

    读取权限被拒绝
    解决方案:用户没有读取数据备份历史数据的权限。请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求URL不正确。
    解决方案:指定一个有效的请求URL。请参阅此页面开头的请求URL部分以获取更多详细信息。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方案:服务器中出现意外且未处理的异常。请联系支持团队。

示例回应