Zoho crm Logo

获取特定交易的联系人角色

目的

获取与特定交易相关联的联系人角色的详细信息

端点

  • GET /Deals/{deal_ID}/Contact_Roles
  • GET /Deals/{deal_ID}/Contact_Roles/{contact_ID}
  • GET /Deals/{deal_ID}/Contact_Roles?ids={contact_ID1,contact_ID2,..}

Request 详情

Request URL

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

获取特定联系人角色:
{api-domain}/crm/{version}/Deals/{deal_id}/Contact_Roles/{contact_id}

获取多个联系人角色:
{api-domain}/crm/{version}/Deals/{deal_id}/Contact_Roles?ids={contact_id1,contact_id2,...}

标题

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

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

可能的操作类型

ALL - 对记录的完全访问
READ - 读取记录

参数

  • ids字符串,可选

    指定联系角色的唯一ID,用逗号分隔。

  • fields字符串,必填

    指定您希望在响应中接收其详细信息的字段的API名称。

样本请求

Response JSON 键

  • Contact_RoleJSON 对象

    代表联系人角色的名称和ID。

  • id字符串

    代表联系人的唯一ID。

可能的错误

  • INVALID_URL_PATTERNHTTP 404

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

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

  • NO_PERMISSIONHTTP 403

    拒绝读取记录的权限
    解决方案:用户没有权限在交易或联系人模块中读取记录。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

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

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

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

  • INVALID_DATAHTTP 400

    给出的相关id似乎无效
    解决方案:指定一个有效的{deal_id}。要获取有效的记录ID,请参考获取记录API。

  • REQUIRED_PARAM_MISSINGHTTP 400

    缺少预期的参数之一
    解决方案:指定必需的参数fields。

示例回应