更新联系人角色
目的
更新联系人角色的详细信息。
端点
- PUT /Contacts/roles
- PUT /Contacts/roles/{contact_role_ID}
请求详情
请求 URL
{api-domain}/crm/{version}/Contacts/roles
要更新特定联系人角色:
{api-domain}/crm/{version}/Contacts/roles/{contact_role_id}
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.contacts.UPDATE
可能的操作类型
全部 - 完全访问记录
写入 - Edit联系人模块中的记录
更新 - Update联系人模块中的记录
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts/roles"
-X PUT
-d "@updatecontactroles.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"输入 JSON 键
- id字符串,必填
指定联系人Role的唯一ID。请参阅获取联系人Role API以获取有效的ID。如果你在请求URL中指定了ID,则无需指定此键。
- name字符串,选填
指定联系人Role的唯一名称。
- sequence_number整数,选填
指定联系人Role在CRM UI中选项列表的位置。
示例输入
Copied{
"contact_roles": [
{
"name": "Sales Lead",
"sequence_number": 5,
"id": "4150868000003611011"
},
{
"name": "Quality Control",
"sequence_number": 6,
"id": "4150868000003611012"
}
]
}可能的错误
- INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方法:指定的请求URL不正确。请指定一个有效的请求URL。请参考上面的请求URL部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未授权
解决方法:客户端没有 ZohoCRM.modules.contacts.UPDATE 权限。请创建具有有效权限的新客户端。参考上方的权限说明部分。 - NO_PERMISSIONHTTP 403
无权更新记录
解决方法:用户没有更新记录的权限。请联系您的系统管理员。 - INTERNAL_ERRORHTTP 500
服务器内部错误
解决方法:服务器出现了意外且未处理的异常。请联系支持团队。 - INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决方法:您已为访问API URL 指定了无效的HTTP方法。请指定有效的请求方法。请参阅上方的端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限来更新记录
解决方法:该用户没有更新记录的权限。请联系您的系统管理员。 - DUPLICATE_DATAHTTP 400
重复数据
解决方法:您为“name”字段指定了重复的值。请在请求输入中指定唯一的联系人角色名称。 - INVALID_DATAHTTP 400
数据无效
解决方法:为 "sequence_number" 键指定的输入不正确。请参考上方的输入JSON键部分,并填写有效的输入。 - MANDATORY_NOT_FOUNDHTTP 400
未找到必填字段
解决方法:请在请求输入中指定要更新的联系人Role的唯一ID。请参考 获取联系人Role API 以获取有效的联系人RoleID。
示例回复
Copied{
"contact_roles": [
{
"code": "SUCCESS",
"details": {
"id": "4150868000003611011"
},
"message": "record updated",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "4150868000003611012"
},
"message": "record updated",
"status": "success"
}
]
}