Zoho crm Logo

删除联系人角色

目的

要删除联系人角色。

端点

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

请求详情

请求 URL

{api-domain}/crm/{version}/Contacts/roles?ids={contact_role_id1,contact_role_id2,..}

要删除特定的联系人角色:
{api-domain}/crm/{version}/Contacts/roles/{contact_role_id}

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

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

可能的操作类型

ALL - 对记录有完全访问权限
Delete - Delete 模块中的记录

参数

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

    指定以逗号分隔的联系人 Role ID。请参阅 获取联系人 Role API 以检索有效的联系人 Role ID。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts/roles?ids=4150868000001015046,4150868000001015042"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

注意

  • 每次 API 调用最多可删除 100 个联系人角色。

Possible Errors

  • INVALID_URL_PATTERN HTTP 404

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

  • OAUTH_SCOPE_MISMATCH HTTP 401

    未授权
    解决方案: 客户端没有ZohoCRM.modules.contacts.DELETE 作用域。请使用有效的作用域创建一个新的客户端。请参阅上面的作用域部分。

  • NO_PERMISSION HTTP 403

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

  • INTERNAL_ERROR HTTP 500

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

  • INVALID_REQUEST_METHOD HTTP 400

    HTTP 请求方法类型无效
    解决方法: 您为访问 APIURL 指定了无效的 HTTP 方法。请指定有效的请求方法。请参阅上面的端点部分。

  • AUTHORIZATION_FAILED HTTP 400

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

  • INVALID_DATA HTTP 400

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

  • REQUIRED_PARAM_MISSING HTTP 400

    缺少一个预期的参数
    解决方案: 在 "ids" 参数中指定要删除的联系人角色的唯一 ID。参阅 获取联系人角色 API 以获取有效的联系人角色 ID。

示例回应

Copied{
    "contact_roles": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000001015046"
            },
            "message": "contact role deleted",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000001015042"
            },
            "message": "contact role deleted",
            "status": "success"
        }
    ]
}