Zoho crm Logo

获取记录合并状态

目的

获取之前安排的记录合并任务的状态。

端点

  • GET /{module_api_name}/{master_record_ID}/actions/merge

Request 详情

Request URL

{api-domain}/crm/{version}/{module_api_name}/{master_record_ID}/actions/merge

支持的模块

潜在客户,联系人,账户,交易,供应商和自定义。

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.{模块名称}.{操作类型}

可能的模块名称

潜在客户,联系人,交易,账户,供应商和自定义。

可能的操作类型

READ - 获取模块中的记录。
ALL - 对记录的完全访问。

参数

  • job_idstring, optional

    ID代表您的预定合并任务的唯一标识符,您可以从合并记录API的响应中获取。

样本请求

响应JSON

  • job_idstring

    指定计划合并作业的唯一ID。

  • status string

    指定预定呼叫的当前状态。 
    可能的值:运行中,已预定,已完成,和失败。

示例回应

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确
    解决方案:使用HTTP GET方法进行此API调用。任何其他请求方法都会导致此错误。

  • INVALID_DATAHTTP 400

    指定的主记录ID无效
    解决方案:请指定有效的主记录ID。

  • INVALID_MODULEHTTP 400

    给出的模块名称似乎无效
    解决方案:您指定的模块名称无效。请指定一个有效的模块名称。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用于进行此API调用的访问令牌没有所需的范围。
    解决方案:客户端没有ZohoCRM.module.{module_api_name}.READ范围。创建一个具有所需范围的新令牌。

  • AUTHENTICATION_FAILUREHTTP 401

    您没有使用有效的访问令牌授权API调用。
    解决方案:  在请求头中包含有效的访问令牌以授权API调用。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方案:指定一个有效的请求URL。请参考本页开头的请求URL部分获取更多详情。请参考上述请求URL部分。

  • INTERNAL_ERRORHTTP 500

    服务器中出现意外和未处理的异常。 
    解决方案:联系support@zohocrm.com的支持团队。