从特定交易中移除联系人角色
目的
要从特定交易中删除联系人角色。
端点
- 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"
}
]
}