Zoho crm Logo

下载附件

目的

在Zoho CRM中检索并下载附加到记录的文件。

 

端点

  • GET /{module_api_name}/{record_ID}/Attachments/{attachment_ID}

Request 详情

Request URL

{api-domain}/crm/{version}/{module_api_name}/{record_ID}/Attachments/{attachment_ID}

支持的模块

潜在客户,账户,联系人,交易,活动,任务,案例,事件,呼叫,解决方案,产品,供应商,价格书,报价,销售订单,采购订单,发票,自定义,预约,服务和笔记

头部

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.modules.ALL
(or)
ZohoCRM.modules.{module_name}.{operation_type}
(and)
ZohoCRM.modules.attachments.{operation_type}

可能的模块名称

潜在客户,账户,联系人,交易,活动,任务,案例,事件,电话,解决方案,产品,供应商,价格表,报价,销售订单,采购订单,发票,自定义,预约,服务和笔记

可能的操作类型

全部 - 对附件的完全访问权限
读取 - 获取附件数据

注意

  • 您只能下载文件类型的附件,而不能下载链接类型的附件。
  • 要检索附件ID,请使用获取相关记录API。

可能的错误

  • DOWNLOAD_NOT_ALLOWEDHTTP 400

    您正在尝试下载链接附件。
    解决方案:您只能通过此API下载文件类型的附件。

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限下载附件。
    解决方案:联系您的系统管理员。

  • INVALID_DATAHTTP 400

    您指定的记录ID无效。
    解决方案:指定一个有效的记录ID。

  • INVALID_MODULEHTTP 400
    • 给出的模块名称似乎无效
      解决方案:您指定的模块名称无效,或者没有标签权限,或者该模块可能已从可用模块中删除。指定一个有效的模块API名称。
    • API不支持给定的模块。
      解决方案:指定一个有效且受支持的模块API名称。参考本页开头的支持模块列表以获取更多详细信息。
  • OAUTH_SCOPE_MISMATCHHTTP 401

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

  • NO_PERMISSIONHTTP 403

    拒绝下载附件的权限。
    解决方案:联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

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

  • INTERNAL_ERRORHTTP 500

    服务器中出现了意外且未处理的异常。 
    解决方案:联系支持团队,邮箱为 support@zohocrm.com。

样本请求

将下载请求的文件。