Zoho crm Logo

将文件上传到 Zoho 文件系统 (ZFS)

目的

ZFS 是您所有文件和附件的核心存储系统。本 API 允许您将文件上传到 ZFS。使用此 API 时,请确保文件的内容类型设置为 multipart/form-data。上传成功后,API 会返回一个加密的文件 ID 以及文件名。您可以使用该加密 ID,将文件附加到 Zoho CRM 中的文件/图片上传字段或记录图片字段,通过 创建 或 Update记录 API 来实现。 

端点

  • POST /files

请求详情

请求URL

{api-domain}/crm/{version}/files

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.文件.{operation_type}

可能的操作类型

创建 - 向 ZFS 添加文件

参数

  • type字符串,可选

    用于上传内嵌图片。
    可能的值:inline

输入表单数据

  • 文件文件,必填

    选择您要上传的文件。每次API调用最多可以上传10个文件,且每个文件的最大大小为20MB。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/files"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-F "file=@connections.txt"
-F "file=@enable-signals.png"
CopiedfileVariable = invokeurl
[
	url: "https://file-examples-com.github.io/uploads/2017/10/file-sample_150kB.pdf"
	type: GET
];
fileVariable.setParamName("file");
response = invokeurl
[
	url :"https://www.zohoapis.com/crm/v8/files"
	type :POST
	files: fileVariable
	connection:"crm_oauth_connection"
];
info response;

可能的错误

  • Failure_in_attachment_handling HTTP 400

    无效的 OAuth scope,无法访问此 URL
    解决方法: 上传附件时出现问题。请正确上传文件。

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限进行创建。
    解决方法:请联系系统管理员。

  • VIRUS_DETECTED HTTP 400

    无法处理您的请求。检测到VirUS。
    解决方法:请上传没有任何virUS的文件。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用于调用此 API 的访问令牌不具备所需的权限范围。
    解决方法:请生成一个包含此 API 所需权限范围的新访问令牌。有关所需权限范围的列表,请参阅本页面开头的权限范围部分。

  • NO_PERMISSIONHTTP 403

    无权限创建
    解决方法:请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方法:请指定有效的请求URL。有关详细信息,请参阅本页开头的请求URL部分。

  • FILE_SIZE_MORE_THAN_ALLOWED_SIZE HTTP 415

    您正在尝试上传的文件超出了最大大小限制。
    解决方法:请上传最大不超过20MB的文件。

  • INTERNAL_ERRORHTTP 500

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

示例回复

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "name": "connections.txt",
                "id": "2cceafaxxxxxxxc065186"
            },
            "message": "connections.txt uploaded Succeessfully",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "name": "enable-signals.png",
                "id": "2ccxxxxxxxxxxxb89e051a"
            },
            "message": "enable-signals.png uploaded Succeessfully",
            "status": "success"
        }
    ]
}