Zoho crm Logo

更新联系人角色

目的

更新联系人角色的详细信息。

端点

  • 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"
        }
    ]
}