删除笔记
Purpose
删除笔记。
Endpoints
- DELETE /Notes/{note_ID}
- DELETE /Notes?ids={Note_ID1, Note_ID2, Note_ID3,..}
- DELETE /{module_API_name}/{record_ID}/Notes/{note_ID}
Request 详情
Request URL
{api-domain}/crm/{version}/Notes/{note_id}
删除多个笔记:
{api-domain}/crm/{version}/Notes?ids={Entity_ID1, Entity_ID2, Entity_ID3,..}
删除特定记录的笔记:
{api-domain}/crm/{version}/{module_api_name}/{record_id}/Notes/{note_id}
支持的模块
Leads, Accounts, Contacts, Deals, Campaigns, Tasks, Cases, Events, Calls, Solutions, Products, Vendors, Price Books, Quotes, Sales Orders, Purchase Orders, Invoices, Appointments, Services and Custom
Header
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
scope=ZohoCRM.modules.ALL
(or)
scope=ZohoCRM.modules.{module_name}.{operation_type}
(and)
scope=ZohoCRM.modules.notes.{operation_type}
可能的模块名称
潜在客户,账户,联系人,交易,活动,任务,事件,电话,案例,事件,电话,解决方案,产品,供应商,价格表,报价,销售订单,采购订单,发票,预约,服务和自定义
可能的操作类型
ALL - 完全访问笔记
WRITE - 编辑笔记数据
DELETE - DELETE 笔记数据
参数
- ids字符串,删除多个笔记时必填
指定要删除的笔记的唯一ID。
注意
您每次API调用最多可以删除100条笔记。
样本请求
Possible Errors
- INVALID_MODULEHTTP 400
给出的模块名称似乎无效
解决方案:您指定的模块名称无效,或者没有标签权限,或者该模块可能已从可用模块中移除。请指定一个有效的模块API名称。 - INVALID_MODULEHTTP 400
给定的模块在API中不受支持
解决方案:当前API不支持诸如文档和项目等模块。(一旦这些模块得到支持,将不会显示此错误)。请指定一个有效的模块API名称。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上面的请求URL部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未经授权
解决方案:客户端没有ZohoCRM.modules.notes.DELETE范围。创建一个具有有效范围的新客户端。请参考上面的范围部分。 - NO_PERMISSIONHTTP 403
Permission denied to delete notes details
Resolution: The user does not have permission to delete notes data. Contact your system administrator. - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。 - INVALID_REQUEST_METHODHTTP 400
所请求的 HTTP 方法类型无效
解决方案:您指定了无效的 HTTP 方法来访问API URL。请指定一个有效的请求方法。请参考上述端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限删除笔记
解决方案: 用户没有删除笔记数据的权限。请联系您的系统管理员。 - INVALID_DATAHTTP 400
record not deleted
Resolution: The note ID specified in the URL is invalid. Refer to Get Notes API to get valid note IDs. - UNABLE_TO_PARSE_DATA_TYPEHTTP 400
请求体或参数的格式错误
解决方案: 参数值的格式错误。请以正确的格式指定有效的记录ID。请参考上述端点部分。 - REQUIRED_PARAM_MISSINGHTTP 400
缺少预期的参数之一
解决方案: 请求中缺少 'ids' 参数。请指定要删除的笔记的 ID。请参考 获取笔记数据 API 获取有效的记录 ID。