获取数据备份下载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
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。