Zoho crm Logo

从特定交易中移除联系人角色

目的

要从特定交易中删除联系人角色。

端点

  • DELETE /Contacts/roles?ids={contact_role_id1,contact_role_id2,..}
  • DELETE /Contacts/roles/{contact_role_id}

请求详情

请求 URL

{api-domain}/crm/{version}/Deals/{deal_id}/Contact_Roles/{contact_Role_id}

要从交易中移除多个联系人Role:
{api-domain}/crm/{version}/Deals/{deal_id}/Contact_Roles?ids={contact_Role1,contact_Role2,..}

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.deals.DELETE
(和)
scope=ZohoCRM.modules.contacts.DELETE

可能的操作类型

全部 - 完全访问记录
Delete - Delete模块中的记录

参数

  • ids字符串,删除多个联系人角色时必填

    指定以逗号分隔的联系人唯一ID

注意

您可以在一次 API 调用中从一个交易中删除最多 100 个联系人角色。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Deals/4150868000003384003/Contact_Roles/4150868000003283024"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

可能的错误

  • INVALID_URL_PATTERNHTTP 404

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

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

  • NO_PERMISSIONHTTP 403

    没有删除记录的权限
    解决方法:用户没有删除记录的权限。请联系系统管理员。

  • INTERNAL_ERRORHTTP 500

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

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限删除联系人角色
    解决方法:用户没有删除联系人角色的权限。请联系系统管理员。

  • INVALID_DATAHTTP 400

    联系人角色未删除
    解决方案: 您尝试删除的联系人角色已经被删除。

  • INVALID_DATAHTTP 400

    提供的相关ID似乎无效
    解决方法:在请求URL中指定有效的{deal_id}。请参阅获取记录API以获取有效的记录ID。

  • INVALID_DATAHTTP 400

    提供的ID似乎无效
    解决方案:在请求URL中指定有效的{contact_id}。请参阅获取记录API以获取有效的记录ID。

  • MANDATORY_NOT_FOUNDHTTP 400

    关系未找到
    解决方案:指定的交易和联系之间没有关系。

示例响应

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000003283024"
            },
            "message": "relation removed",
            "status": "success"
        }
    ]
}