Zoho crm Logo

获取联系人角色

当多个联系人与交易/机会相关联时,联系人的详细信息存储在联系人角色相关列表中。

目的

获取联系人角色的列表。

端点

  • 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。

示例回应