Zoho crm Logo

上传照片

目的

要将照片附加到Zoho CRM中的一条记录上,您必须在请求中以 multipart/form-data 的内容类型包含该照片。

端点

  • POST /{module_api_name}/{record_ID}/photo

请求详情

请求 URL

{api-domain}/crm/{version}/{module_api_name}/{record_ID}/photo

支持的模块

线索、联系人、Account、产品、交易、Vendors以及自定义模块

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.modules.ALL
(或)
ZohoCRM.modules.{module_name}.{operation_type}

可能的模块名称

线索、联系人、账户、产品、交易、供应商以及自定义模块

可能的操作类型

全部 - 完全访问图片
编辑 - Edit图片数据
创建 - 创建图片数据

参数

  • restrict_triggers字符串,可选

    使用此参数可以防止系统触发关联的工作流。 
    可能的取值:workflow

输入

  • 文件文件,必填

    请选择你要上传的照片。支持的图片格式有:PNG、JPEG、JPG、GIF 和 BMP。

注意

  • 照片的最大允许大小为10 MB。
  • 照片的分辨率不得超过10 MP。
  • 您无法向处于锁定状态的记录上传照片。

样品申请

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/3000000038009/photo?restrict_triggers=workflow"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-F "file=@img1.png"

在请求中,“file=@img1.png”包含了示例输入图片。

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方法:使用 HTTP PUT 方法来调用此 API。使用其他请求方法将会导致此错误。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限上传照片。
    解决方法: 请联系您的系统管理员。

  • INVALID_DATAHTTP 400

    您指定了无效的记录ID。
    解决方法:请指定有效的记录ID。

  • RECORD_LOCKEDHTTP 400

    您无法执行此操作,因为该记录已被锁定。
    解决方法: 请等待该记录解锁后再操作。

  • INVALID_MODULEHTTP 400
    • 提供的模块名称似乎无效。
      解决方法:请指定一个有效的模块。
    • 所提供的模块在 API 中不受支持。
      解决方法:如“文档”和“项目”等模块在当前 API 中不受支持。请指定一个受支持的模块 API 名称。请参阅本页开头的受支持模块部分。
  • OAUTH_SCOPE_MISMATCHHTTP 401

    未授权
    解决方法:客户端没有ZohoCRM.modules.{module_name}.CREATE的权限。请生成一个具有有效权限的新访问令牌。请参考本页面开头的权限部分。

  • NO_PERMISSIONHTTP 403

    没有权限上传照片
    解决方法:请联系系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方法:请指定有效的请求URL。更多详情请参考本页开头的 请求URL部分。

  • FILE_SIZE_MORE_THAN_ALLOWED_SIZE HTTP 415

    请检查文件大小是否在正确的范围内。
    解决方法:您尝试上传的照片超过了允许的大小(10 MB)或分辨率(10 MP)。请确保照片的大小和分辨率在允许的范围内。

  • INTERNAL_ERRORHTTP 500

    服务器出现意外且未处理的异常。 
    解决方法:请联系支持团队:support@zohocrm.com。

示例回复

Copied{
    "code": "SUCCESS",
    "details": {},
    "message": "photo uploaded successfully",
    "status": "success"
}