获取联系人角色
当多个联系人与交易/机会相关联时,联系人的详细信息存储在联系人角色相关列表中。
目的
获取联系人角色的列表。
端点
- GET /Contacts/roles
- GET /Contacts/roles/{contact_role_ID}
Request 详情
Request URL
{api-domain}/crm/{version}/Contacts/roles
获取特定联系人角色:
{api-domain}/crm/{version}/Contacts/roles/{contact_role_ID}
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.modules.ALL
(或者)
ZohoCRM.modules.contacts.{operation_type}
可能的操作类型
ALL - 对联系人的完全访问权限
READ - 读取联系人
样本请求
Response JSON 键
- sequence_numberinteger
代表联系人角色在CRM UI中的下拉列表中的位置。
- namestring
代表联系人角色的名称。
- idstring
代表联系人角色的唯一ID。
可能的错误
- INVALID_REQUEST_METHODHTTP 400
请求方法不正确。
解决方案: 使用 HTTP GET 方法来进行此API调用。任何其他请求方法都会导致此错误。 - AUTHORIZATION_FAILEDHTTP 400
您没有足够的权限添加子表单或模块记录。
解决方案:联系您的系统管理员。 - OAUTH_SCOPE_MISMATCHHTTP 401
您用来进行此API调用的访问令牌没有所需的范围。
解决方案:生成一个新的访问令牌,其范围在范围部分中有所提及。 - NO_PERMISSIONHTTP 403
拒绝读取记录的权限
解决方案:用户没有读取记录的权限。请联系您的系统管理员。 - INVALID_URL_PATTERNHTTP 404
Request URL不正确。
解决方案:指定一个有效的Request URL。请参考Request URL部分以获取正确的URL。 - INTERNAL_ERRORHTTP 500
服务器中出现意外且未处理的异常。
解决方案:联系支持团队,邮箱为support@zohocrm.com。