错误代码

Marketo REST API在HTTP、响应或记录级别返回错误。 本页说明每种错误类型并列出相关的错误代码。

处理和记录异常

当集成遇到意外异常时，记录请求和响应。 某些异常（如过期的身份验证）可以通过重新身份验证来处理。 其他例外情况可能需要支持部门的帮助，他们将请求相关的请求和响应详细信息。

错误类型

Marketo REST API在正常操作期间可能会返回三种类型的错误：

响应级别和记录级别错误返回HTTP状态代码200。 对于所有错误类型，请勿评估HTTP原因短语，因为它是可选的且可能会发生更改。

HTTP级别错误

在正常操作期间，Marketo返回两个HTTP状态代码错误： 413 Request Entity Too Large和414 Request URI Too Long。 要从任一错误中恢复，请修改请求并重试。 您可以在提交之前通过检查请求大小来避免这些错误。

当请求有效负载超过1MB时，Marketo会返回413，如果导入商机超过10MB，则会返回413。 在提交之前检查请求大小。 如果记录导致请求超出限制，请将这些记录移动到另一个请求。

当GET请求的URI超过8KB时，Marketo返回414。 在提交之前检查查询字符串长度。 如果超过限制，请将请求方法更改为POST，将查询字符串放入请求正文中，然后添加_method=GET参数。 长URI在检索具有较长过滤值（如GUID）的大型记录批次时最常见。

Identity终结点可能返回401 Unauthorized错误，通常是因为客户端ID或客户端密钥无效。 下表列出了HTTP级别的错误代码。

响应级别错误

当响应将success参数设置为false时，会发生响应级别错误。 它们使用以下结构：

{
    "requestId": "e42b#14272d07d78",
    "success": false,
    "errors": [
        {
            "code": "601",
            "message": "Unauthorized"
        }
    ]
}

“errors”数组中的每个对象都包含两个成员：

6xx代码指示整个请求失败且未执行。 例如，通过重新身份验证并使用请求传递新访问令牌，从601“访问令牌无效”错误中恢复。

7xx代码指示请求失败，因为未返回数据或请求参数无效。 原因包括日期无效或缺少所需的参数。

响应级错误代码

记录级别 record_level_errors

记录级别的错误表示请求有效，但单个记录的操作无法完成。 具有记录级错误的响应遵循以下模式：

响应

{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "id":50,
         "status":"created"
      },
      {
         "id":51,
         "status":"created"
      },
      {
         "status":"skipped",
         "reasons":[
            {
               "code":"1005",
               "message":"Lead already exists"
            }
         ]
      }
   ]
}

结果数组中的记录与请求输入数组中的记录显示顺序相同。 每个记录都可以独立成功或失败，如其状态字段所示。

对于失败的记录，“状态”字段为“已跳过”，记录中包含“原因”数组。 每个原因都包含一个“代码”成员和一个“消息”成员。 代码始终为1xxx，该消息说明了跳过记录的原因。

例如，如果“同步销售线索”请求将“action”设置为“createOnly”，并且其中一个已提交的键已存在销售线索，则响应将返回代码1005，并返回消息“Lead already exists”，如上所示。

记录级错误代码