获取记录的领土
目的
要获取分配给您Zoho CRM 组织中记录的领土详细信息。
端点
- GET /{module_api_name}/{record_id}
请求详情
请求URL
{api-domain}/crm/{version}/{module_api_name}/{record_id}
支持的模块
潜在客户,Account,联系人和交易
标题
授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.modules.ALL
(或)
ZohoCRM.modules.{module_name}.{operation_type}
可能的模块名称
线索、账户、联系人和交易
可能的操作类型
全部 - 完全访问记录
读取 - 读取模块中的记录
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/Deals/554023000000497035"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X GET响应 JSON
- Name string
表示领土的Name。
- id string
表示领土的唯一ID。
- $assigned_byJSON object
表示将区域分配给记录的用户的姓名和ID。
- $assigned_time string
表示将区域分配给记录的日期和时间。
- $assigned string
表示记录的领土是如何分配的。
可能的值:
manually: 用户通过API或UI手动分配领土。
automatically: 系统自动分配领土。
可能的错误
- INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决方法:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅上面的端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限访问记录
解决方案:用户没有访问记录的权限。请联系您的系统管理员。 - OAUTH_SCOPE_MISMATCHHTTP 401
您用于进行此 API 调用的访问令牌不具有所需的范围。
解决方法:生成一个具有此 API 所需范围的新访问令牌。请参阅本页开头的范围部分以获取所需范围的列表。 - NO_PERMISSIONHTTP 403
无权限读取记录
解决方案:用户没有读取记录的权限。请联系系统管理员。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。
示例响应
Copied{
"data": [
{
"Owner": {
"name": "Patricia Boyle",
"id": "111111000000043376",
"email": "p.boyle@abc.com"
},
"Territories": [
{
"Name": "Texas",
"id": "111111000000046898",
"$assigned_by": null,
"$assigned_time": "2020-03-05T16:07:28+05:30",
"$assigned": "automatically"
},
{
"Name": "South",
"id": "111111000000046458",
"$assigned_by": {
"name": "Patricia Boyle",
"id": "111111000000043376"
},
"$assigned_time": "2020-03-05T16:07:28+05:30",
"$assigned": "manually"
}
]
}
]
}