获取特定交易的联系人角色
目的
获取与特定交易相关联的联系人角色的详细信息
端点
- 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。