Zoho crm Logo

取消关联的记录

目的

删除模块之间的关联。

端点

  • DELETE /{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}
  • DELETE /{module_api_name}/{record_id}/{related_list_apiname}?ids={comma_separated_related_record_ids}

Request 详细信息

Request URL

{api-domain}/crm/{version}/{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}

删除多个相关记录:
{api-domain}/crm/{version}/{module_api_name}/{record_id}/{related_list_api_name}?ids={comma_separated_related_record_ids}

支持的关系

活动 - 至 - 潜在客户,联系人
产品 - 至 - 潜在客户,账户,
联系人,潜力,价格书
预约 - 至 - 服务

Header

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

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

可能的模块名称

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

Possible operation types

ALL - 完全访问记录
WRITE - 编辑相关记录
DELETE - DELETE 相关记录

参数

  • ids字符串,当取消链接多个相关记录时为必填

    指定用逗号分隔的相关记录ID。

注意

  • 您可以通过API调用删除最多100条相关记录,也就是说,您可以在请求URL中指定最多100个相关记录ID。

样本请求

可能的错误

  • INVALID_MODULEHTTP 400

    给出的模块名称似乎无效
    解决方案:您指定的模块名称无效,或者没有标签权限,或者该模块可能已从可用模块中删除。请指定一个有效的模块API名称。

  • INVALID_MODULEHTTP 400

    给定的模块在API中不受支持
    解决方案:当前API不支持诸如文档和项目等模块。(一旦这些模块得到支持,此错误将不会显示)。请指定一个有效的模块API名称。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上述请求URL部分。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.modules.{module_name}.DELETE范围。创建一个具有有效范围的新客户端。请参考上面的范围部分。

  • NO_PERMISSIONHTTP 403

    拒绝删除记录的权限
    解决方案:用户没有删除相关记录数据的权限。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方案:服务器中出现意外且未处理的异常。请联系支持团队。

  • INVALID_REQUEST_METHODHTTP 400

    http请求方法类型不是有效的
    解决方案:您指定了无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参考上述端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

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

  • INVALID_DATAHTTP 400

    提供的相关id似乎无效
    解决方案:您指定的相关记录ID不正确。请指定一个有效的记录ID。请参考获取相关记录API以获取有效的记录ID。

  • UNABLE_TO_PARSE_DATA_TYPEHTTP 400

    请求体或参数的格式错误
    解决方案:参数值的格式错误。请以正确的格式指定有效的记录ID。请参考上述端点部分。

样本回应