Zoho crm Logo

将联系人角色添加到特定交易

目的

向特定交易添加联系人角色。

端点

  • PUT /Deals/{deal_ID}/Contact_Roles/{contact_id}

Request 详情

Request URL

{api-domain}/crm/{version}/Deals/{deal_id}/Contact_Roles/{contact_id}

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

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

可能的操作类型

ALL - 对记录的完全访问
WRITE - 编辑记录
UPDATE - 更新记录

样本输入

输入 JSON 键

  • Contact_RoleJSON 对象,必填

    指定要分配的联系角色的名称和ID。要获取有效的联系角色,请参考 获取联系角色API。

样本输入

可能的错误

  • INVALID_URL_PATTERNHTTP 404

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.modules.contacts.UPDATE(或)ZohoCRM.modules.deals.UPDATE范围。创建具有有效范围的新客户端。请参阅上述范围部分。

  • NO_PERMISSIONHTTP 403

    拒绝权限更新记录
    解决方案:用户没有权限更新记录。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

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

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来更新记录
    解决方案:用户没有更新记录的权限。请联系您的系统管理员。

  • MANDATORY_NOT_FOUNDHTTP 400

    未找到必填字段
    解决方案:在您的请求输入中指定联系人角色的API名称。参考获取联系人角色API以获取有效的联系人角色名称。

  • INVALID_DATAHTTP 400

    提供的相关id似乎无效
    解决方案: 请求URL中指定的{deal_id}无效。请指定一个有效的{deal_id}。请参考获取记录API以获取有效的记录ID。

  • INVALID_DATAHTTP 400

    给出的id似乎无效
    解决方案:请求URL中指定的{contact_id}无效。请指定一个有效的{contact_id}。请参考获取记录API以获取有效的记录ID。

  • INVALID_DATAHTTP 400

    无效的数据
    解决方案:请求输入中指定的联系角色的API名称无效。请指定一个有效的联系角色API名称。要通过API获取相同的信息,请参考获取联系角色API。

样本回应