将文件上传到 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"
}
]
}