Zoho crm Logo

使用外部ID删除相关记录

目的

使用外部ID删除相关列表记录。

端点

  • DELETE /{module_API_name}/{external_field_value}/{related_list_API_name}/{external_field_value}

请求详情

Request URL

{api-domain}/crm/{version}/{module_API_name}/{external_field_value}/{related_list_API_name}/{external_field_value}

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

X-EXTERNAL: {module_API_name}.{external_field_API_name}

范围

ZohoCRM.modules.all
(或者)
ZohoCRM.modules.{模块名称}.{操作类型}

可能的模块名称

潜在客户,交易,联系人,账户,产品,活动,预约,服务和价格手册

可能的操作类型

ALL - 完全访问相关记录
WRITE - 编辑相关记录
DELETE - 从模块中DELETE相关记录

使用外部ID解除联系人和交易的链接
  • 在这个例子中,extcontact3 和 extdeal3 分别是联系人和交易模块中 External_Contact_ID 和 External_Deal_ID 的外部字段值。我们将引用这些值来解除交易与联系人的链接。

样本请求

可能的错误

  • INVALID_DATAHTTP 400

    您指定的相关记录的外部ID或基础模块的记录错误。响应中的详细信息键会告诉您哪个外部字段的ID是错误的。
    解决方案:指定正确的相关记录的外部ID。

  • AUTHORIZATION_FAILEDHTTP 400

    您没有足够的权限删除相关记录。
    解决方案:联系您的系统管理员。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成一个新的访问令牌,其范围在范围部分中有所提及。

  • NO_PERMISSIONHTTP 403

    您没有权限删除相关记录。
    解决方案:联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方案:指定一个有效的请求URL。请参考请求URL部分以获取正确的URL。

  • INTERNAL_ERRORHTTP 500

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

样本回应