删除联系人角色
目的
要删除联系人角色。
端点
- 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"
}
]
}