Zoho crm Logo

插入联系人角色

目的

添加新的联系人角色。

端点

  • POST /Contacts/roles

请求详情

请求 URL

{api-domain}/crm/{version}/Contacts/roles

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.contacts.{operation_type}

可能的操作类型

全部 - 完全访问联系人
写入 - Edit 联系人模块中的记录
创建 - 在联系人模块中创建记录

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts/roles"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@newcontactrole.json"
-X POST

输入 JSON 键

要添加联系人角色,请发送包含以下属性的请求正文的 POST 请求:

  • name string,mandatory

    指定联系人角色的名称。
    示例: Sales 负责人

  • sequence_number integer,optional

    指定联系人角色在 CRM UI 中选择列表中的位OS置。

注意

  • 每次 API 调用最多可以插入100 个联系人角色。

示例输入

Copied{
    "contact_roles": [
        {
            "name": "Sales Lead",
            "sequence_number": 1
        },
        {
            "name": "Quality Control",
            "sequence_number": 2
        }
    ]
}

可能的错误

  • INVALID_URL_PATTERNHTTP 404

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.modules.contacts.CREATE范围。创建一个具有有效范围的新客户端。请参阅上面的范围部分。

  • NO_PERMISSIONHTTP 403

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

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方法:服务器中出现意外且未处理的异常。请联系支持团队。

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方案:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅上面的端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限添加变量
    解决方案:用户没有添加变量的权限。请联系系统管理员。

  • DUPLICATE_DATAHTTP 400

    重复数据
    解决方法: 您为“name”字段指定了一个重复的值。请在请求输入中指定一个唯一的联系人角色名称。

  • INVALID_DATAHTTP 400

    数据无效
    解决方法: 为 "sequence_number" 键指定的输入不正确。请参阅上面的输入 JSON 键部分,并指定有效的输入。

  • MANDATORY_NOT_FOUNDHTTP 400

    必填字段未找到
    解决方法:在请求输入中指定“name”键。

  • LIMIT_EXCEEDEDHTTP 400

    联系人Role功能限制超出
    解决方案:您最多只能有100个联系人Role。

示例响应

Copied{
    "contact_roles": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000003611011"
            },
            "message": "contact role added",
            "status": "success"
        },
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000003611012"
            },
            "message": "contact role added",
            "status": "success"
        }
    ]
}