错误代码

最近更新： 2024年10月17日
  • 主题：

创建对象：

  • 管理员

以下是REST API错误代码列表，并说明如何将错误返回给应用程序。

处理和记录异常

在针对Marketo进行开发时，如果遇到意外异常，请务必记录请求和响应。 虽然重新身份验证可以安全地处理某些类型的异常（例如过期的身份验证），但其他异常可能需要支持交互，在此情况下将始终请求请求和响应。

错误类型

在正常操作下，Marketo REST API可以返回三种不同类型的错误：

  • HTTP级别：这些错误由4xx代码指示。
  • 响应级别：这些错误包含在JSON响应的“错误”数组中。
  • 记录级别：这些错误包含在JSON响应的“result”数组中，并且是以“status”字段和“reasons”数组单独记录为基础指示的。

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

HTTP级别错误

在正常操作情况下，Marketo应仅返回两个HTTP状态代码错误： 413 Request Entity Too Large和414 Request URI Too Long。 通过捕获错误、修改请求和重试，这些都可恢复，但通过智能编码实践，您绝不应该在野外遇到这些情况。

如果请求有效负载超过1MB，Marketo将返回413，对于Import Lead将返回10MB。 在大多数情况下，不会达到这些限制，但是如果向请求的大小添加检查，并移动任何记录，导致超过新请求的限制，则应防止出现任何情况，这种情况会导致任何端点返回此错误。

当GET请求的URI超过8KB时，将返回414。 要避免出现这种情况，请检查查询字符串的长度，看看是否超过此限制。 如果它确实将您的请求更改为POST方法，则使用附加参数_method=GET将您的查询字符串输入为请求正文。 这放弃了URI的限制。 在大多数情况下，很少达到此限制，但在检索具有长单个过滤器值（如GUID）的大量记录时，这种情况比较常见。
标识终结点可能返回401未授权错误。 这通常是由于无效的客户端ID或无效的客户端密钥。 HTTP级别的错误代码

响应代码描述注释
413请求实体太大有效负载超出1MB限制。
414请求URI过长请求的URI超过了8k。 该请求应作为在URL中带有param '_method=GET'的POST进行重试，其余查询字符串应作为请求正文重试。

响应级别错误

将响应的success参数设置为false时，将出现响应级别错误，其结构如下所示：

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

“错误”数组中的每个对象都有两个成员，code，它是从601到799的带引号的整数，一个message提供了错误的纯文本原因。 6xx代码始终指示请求完全失败并且未执行。 例如，“访问令牌无效”601可通过重新身份验证并使用请求传递新访问令牌而恢复。 7xx错误表示请求失败，可能是因为未返回任何数据，或者请求被错误地参数化，如包含无效的日期，或缺少所需的参数。

响应级错误代码

返回此响应代码的API调用不会计入每日配额或速率限制中。

响应代码描述注释
502错误网关远程服务器返回了一个错误。 可能是超时。 应重试该请求，并返回指数回退。
601*访问令牌无效请求中包含访问令牌参数，但值不是有效的访问令牌。
602*访问令牌已过期调用中包含的访问令牌因过期而不再有效。
603访问被拒绝身份验证成功，但用户没有足够的权限调用此API。 [其他权限](custom-services.md)可能需要分配给用户允许列表，或可能启用角色以访问基于IP的API。
604*请求超时请求运行时间过长（例如，遇到数据库争用），或超过了调用标头中指定的超时期限。
605*不支持HTTP方法同步潜在客户端点不支持GET。 必须使用POST。
606最大速率限制“%s”；超出了“%s”秒中的限制过去20秒内的呼叫数大于100
607已达到每日配额今天的呼叫数超过了订阅的配额（CST每天凌晨12:00重置）。>可以在“管理员” — >“Web服务”菜单中找到您的配额。 您可以通过帐户管理员增加配额。
608*API暂时不可用
609JSON无效请求中包含的主体不是有效的JSON。
610未找到请求的资源调用中的URI与REST API资源类型不匹配。 这通常是由于URI拼写错误或格式错误所致
611*系统错误所有未处理的异常
612内容类型无效如果看到此错误，请向请求添加一个指定JSON格式的内容类型标头。 例如，尝试使用“content type： application/json”。 有关更多详细信息，请参阅此StackOverflow问题。
613无效的多部分请求POST的多部分内容格式不正确
614订阅无效找不到目标订阅或目标订阅无法访问。 这通常表示暂时无法访问。
615已达到并发访问限制一次最多由任何订阅10处理请求。 如果已经有10个正在进行的请求，则会返回此项。
616订阅类型无效访问自定义对象元数据API需要适当的Marketo订阅类型。 有关详细信息，请咨询您的CSM。
701%s不能为空请求中报告的字段不能为空
702未找到给定搜索方案的数据没有与给定搜索参数匹配的记录。 注意：许多失败的搜索操作返回“success = true”，并且没有错误，同时设置了警告信息字符串。
703订阅未启用该功能用户订阅中未启用的测试版功能
704日期格式无效
  • 指定的日期格式不正确
  • 指定的动态内容ID无效
709违反业务规则

调用无法完成，因为它违反了创建或更新资产的要求，例如，尝试在没有模板的情况下创建电子邮件。 尝试以下操作时也可能出现此错误：

  • 检索包含社交内容的登陆页面的内容。
  • 克隆包含特定资产类型的程序（有关详细信息，请参阅程序克隆）。
  • 批准没有草稿（即已批准）的资产。
710未找到父文件夹找不到指定的父文件夹
711不兼容的文件夹类型指定的文件夹的类型不正确，无法完成请求
712合并到人员帐户操作无效由于尝试合并Salesforce人员帐户中的潜在客户，合并潜在客户调用失败。 Salesforce人员帐户必须合并到Salesforce中。
713暂时性错误在API调用时，系统资源暂时不可用。 遇到此错误时，建议等待一段时间，然后重试请求。
714找不到默认记录类型由于无法找到默认记录类型，合并潜在客户调用失败。
718未找到ExternalSalesPersonID使用不存在的“ExternalSalesPersonID”值执行了同步机会调用。
719锁定等待超时异常已发出克隆程序调用，等待锁定时超时。