Zoho crm Logo

上传附件

目的

上传附件 API 允许您向 Zoho CRM 中的记录附加文件或链接。请在请求中以 multipart/form data 类型包含附件。

 

端点

  • POST /{module_api_name}/{record_ID}/Attachments

请求详情

请求 URL

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

支持的模块

潜在客户,Account,联系人,交易,活动,任务,案例,事件,通话,解决方案,产品,Vendors,价目表,报价单,SalesOrders,采购Orders,Invoices,自定义,预约,服务和笔记

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.modules.ALL
(或)
ZohoCRM.modules.{module_name}.{operation_type}
(以及)
ZohoCRM.modules.attachments.{operation_type}

可能的模块名称

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

可能的操作类型

ALL - 完全访问附件
WRITE - Edit附件数据
CREATE - 创建附件数据

输入表单数据

  • 文件文件,必填

    请选择你要上传的附件。

参数

  • title字符串,可选

    附件链接的标题。默认情况下,将页面的 meta 标题作为附件链接的标题添加。

注意

在一次 API 调用中,您可以添加文件或附件链接,但不能同时添加两者。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/1000000231009/Attachments"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-F "file=@attachment1.txt" (to upload file) 
(or)
-F "attachmentUrl=https://www.zohocorp.com" (to upload link)
Copiedphoto = invokeUrl
[
	url: "https://pbs.twimg.com/text.txt"
	type: GET
];
photo.setParamName("file");
response = invokeurl
[
	url: "https://www.zohoapis.com/crm/v8/Leads/1000000231009/Attachments"
	type: POST
	files: text file
	connection:"crm_oauth_connection"
];

可能的错误

  • INVALID_MODULEHTTP 400

    所提供的模块名称似乎无效,或者您指定了一个不支持的模块。
    解决方法:请指定一个有效且受支持的模块 API 名称。

  • INVALID_REQUESTHTTP 400
    • 您尚未在请求中添加多部分表单数据。
      解决方法:添加需要上传的文件或链接作为多部分表单数据。
    • 您在输入中添加了多个文件或链接。
      解决方法:输入中只添加一个文件或链接。
  • INVALID_DATAHTTP 400

    同时提供了附件内容和附件链接。一次只能提供其中一个。
    解决方法: 添加文件或链接作为输入。

  • AUTHORIZATION_FAILEDHTTP 400

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

  • AUTHENTICATION_FAILUREHTTP 401

    您未使用有效的访问令牌授权 API 调用。
    解决方法:在请求头中包含有效的访问令牌以授权 API 调用。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未授权
    解决方法:创建一个具有有效权限范围的新访问令牌。有关更多详情,请参阅本页面开头的权限范围部分。

  • NO_PERMISSIONHTTP 403

    无权上传附件
    解决方法:请联系系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方法:请求的URL不正确。请指定一个有效的请求URL。请参考本页开头的请求URL部分。

  • INTERNAL_ERRORHTTP 500

    服务器内部错误
    解决方法:服务器发生了意外且未处理的异常。请联系支持团队。

示例回复

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "Modified_Time": "2021-05-03T18:03:00+05:30",
                "Modified_By": {
                    "name": "Patricia Boyle",
                    "id": "4150868000000225013"
                },
                "Created_Time": "2021-05-03T18:03:00+05:30",
                "id": "4150868000005277036",
                "Created_By": {
                    "name": "Patricia Boyle",
                    "id": "4150868000000225013"
                }
            },
            "message": "attachment uploaded successfully",
            "status": "success"
        }
    ]
}