错误的类型以及如何处理它们

如果请求无法完成, 空气污染指数市区返回响应中的参数 errors. 它包含错误代码（参数 code）及其简要说明（参数 message).

错误代码是什么意思？

密码	标题	发生了什么，该怎么做
400	`Bad Request`	请求内容有问题。例如，JSON数据格式存在错误，或者您正在尝试更改已取消或已交付订单的状态。专注于错误描述，以了解究竟是什么错误。
401	`Unauthorized`	授权令牌未在请求中指定（或已指定，但不在那里）。
403	`Forbidden`	访问被拒绝：无效的授权数据或对资源没有权限。另一个访问错误。
404	`Not Found`	找不到请求的方法或资源。检查系统使用的请求地址。
405	`Method Not Allowed`	在指定的资源上没有这样的方法。检查系统使用的请求地址。
415	`Unsupported Media Type`	方法不支持所请求的内容类型。检查请求的正确性。
420	`Enhance Your Calm`	已超过请求限制。确保您的系统不会发送任何多余的内容。
499	`Client Closed Request`	客户端在侧面处理请求之前关闭了连接。都市人 . 检查客户端的超时并重复请求。
500	`Internal Server Error`	内部错误都市人 .
503	`Service Unavailable`	服务器都市人超载。

查询内容中的错误(400)

在所有方法中发现的错误

资料描述	翻译	怎么办	发生错误的方法
'field' elements must be not null (rejected value: 'value')	收集项目不应 `null`.	用值删除或替换元素 `null`.	它在所有方法中找到。
'field' must be greater than 'value' (rejected value: 'value')	值必须严格大于阈值。	指定可接受范围内的值。	它在所有方法中找到。
'field' must be greater than or equal to 'value' (rejected value: 'value')	值必须大于或等于阈值。	指定可接受范围内的值。	它在所有方法中找到。
'field' must be less than or equal to 'value' (rejected value: 'value')	值必须小于或等于阈值。	指定可接受范围内的值。	它在所有方法中找到。
'field' must match 'regexp' (rejected value: 'value')	值与所需模板不匹配。	传递正则表达式对应的值。	它在所有方法中找到。
'field' must not be empty (rejected value: 'value')	字段不能为空。	传递非空字段值。	它在所有方法中找到。
'field' must not be null (rejected value: null)	必填字段未通过。	指定字段值。	它在所有方法中找到。
'field' size must be between 'min' and 'max' (rejected size: 'size')	无效集合大小：必须从"min"到"max"。	将元素数量更改为可接受。	它在所有方法中找到。
'field' size must be between 'min' and 'max' (rejected value: 'value')	无效值长度：必须从"min"到"max"。	传递允许长度的值。	它在所有方法中找到。
Campaign type is not allowed. Allowed campaign types: 'campaignTypes'	此方法不支持商店的运营模式。	确保使用支持商店运营模式的方法。	它在所有方法中找到。
Content type 'contentType' not supported	不支持请求的内容类型。	在标头中传递支持的内容类型之一 `Content-Type`. 详细了解输入数据格式	它在所有方法中找到。
Illegal input at 'path'	指定路径的无效值。	使用指定的路径检查请求正文中的结构和类型；更正字段名称和值格式以匹配预期的JSON架构。如果内容类型不是JSON，请指定正确的类型。 `Content-Type`.	它在所有方法中找到。
JSON: {message}	JSON数据格式包含错误。	检查JSON的正确性。	它在所有方法中找到。
Required request body is missing	请求体是必需的，但尚未传输。	确保您已经传递了需要它的方法的请求正文。	它在所有方法中找到。
Required request parameter 'param' is not present	未传递所需参数。	确保您已为所使用的方法传递了所有必需的输入参数。	它在所有方法中找到。
The request is too big: Maximum allowed request size must be less than 'maxSize' KB, but passed 'size' MB	请求过大：传输的请求的大小大于允许的最大值。	减少请求体；如果体积很大，则将数据拆分为几个较小的请求，以便每个请求都不超过限制。	它在所有方法中找到。
The request is too big: {message}	已超过HTTP请求大小限制。	内容的大小不能超过512KB。将请求分成几个。	它在所有方法中找到。
Type mismatch: 'value'	输入值类型与预期参数类型不匹配。	以正确的格式和类型传递值，可以在相应的方法页面上查看。	它在所有方法中找到。
Unexpected end of content	请求体意外结束。	检查请求体中传输的数据的格式的正确性。	它在所有方法中找到。
Incorrect X-Business-Id header value: 'value'	标头值不正确 `X-Business-Id`.	在标题中输入机柜ID的正确正数值。 `X-Business-Id`.	它在所有方法中找到。
URL businessId ('urlBusinessId') does not match businessId in X-Business-Id header ('headerBusinessId')	帐户编号 URL 与标头中的标识符不匹配 `X-Business-Id`.	确保 `businessId` 在 URL 匹配标题中的值 `X-Business-Id`.	它在所有的方法中被发现。 `businessId` 传送至 URL.

401未经授权的错误

资料描述	翻译	怎么办	发生错误的方法
Api-Key token is invalid	Api-Key-令牌无效。	检查拼写 Api-Key-令牌。如果错误仍然存在，请获取新令牌。怎么做	它在所有方法中找到。
Api-Key token is not specified	未在请求中指定 Api-Key-令牌。	传下去 Api-Key-标题中的标记 `Api-Key` 由指示说明.	它在所有方法中找到。
Api-Key token length invalid	长度不正确 Api-Key-令牌。	检查拼写 Api-Key-令牌。如果错误仍然存在，请获取新令牌。怎么做	它在所有方法中找到。
Api-Key token prefix invalid	前缀不正确 Api-Key-令牌。	确保在标头中不使用前缀。 `Bearer`. 如何传送 Api-Key-令牌如果没有前缀，请检查拼写。 Api-Key-令牌。如果错误仍然存在，请获取新令牌。怎么做	它在所有方法中找到。
Api-Key token format invalid	格式不正确 Api-Key-令牌。	检查拼写 Api-Key-令牌。如果错误仍然存在，请获取新令牌。怎么做	它在所有方法中找到。
Api-Key token is revoked	Api-Key-令牌已被删除。	获得一个新的令牌。怎么做	它在所有方法中找到。

403禁止的错误

资料描述	翻译	怎么办	发生错误的方法
Access denied	访问被拒绝。	检查是否正确指定了资源，以及在请求中使用其授权令牌的用户是否具有对其的访问权限。有关access的更多信息	它在所有方法中找到。
The method is deprecated and is occasionally forbidden. Please stop using it	该方法已经过时，并且对其的一些请求被拒绝。不要用它。	切换到文档中指定的当前方法。错误将返回给继续调用过时方法的集成；此类响应的比例会随着时间的推移而增加。	它在所有方法中找到。

404未找到错误

Report not found.

未找到请求中指定的报告或文档。

检查报告或文档的传输ID的正确性。

GET v2/reports/info/{reportId}

Resource not found

找不到资源。

检查准确性 URL 和HTTP方法，它们可以在方法页面的文档中查看。
确保您使用的是正确版本的方法。

了解有关调用方法的详细信息

它在所有方法中找到。

错误405方法不允许

资料描述	翻译	怎么办	发生错误的方法
Request method 'method' not supported	不支持请求的HTTP方法。	检查资源支持的方法。	它在所有方法中找到。

错误415不支持的媒体类型

资料描述	翻译	怎么办	发生错误的方法
Content type 'content-type' not supported	不支持请求的内容类型。	传输所支持的内容类型之一。	它在所有方法中找到。
Unknown content-type: 'content-type'	请求的内容类型 — 未知。	传输所支持的内容类型之一。	它在所有方法中找到。

错误420增强你的冷静

资料描述	翻译	怎么办	发生错误的方法
Hit rate limit of 'N' parallel requests for {entity}	超过了同时向 Yandex Market API. 它是什么	将特定实体的并行API请求数量减少到 `N` 请求。	它在所有方法中找到。
Hit rate limit of 'N' requests per 'period' for resource 'R' for {entity}	超过资源限制的数目 `N` 资源请求 `R` 期间 `period` 为特定实体。它是什么	时间限制在标题中指定。 `X-RateLimit-Resource-Until`. 该资源的使用将在指定时间之后成为可能。	它在所有方法中找到。
Active reports limit exceeded, limit='limit'	已超过同时生成的报告数量的限制。	在创建新报告之前，请等待生成以前的报告。同一时间生成的报告数量取决于您的数据计划。阅读更多关于卖家订阅的信息在市场对卖家的帮助.	它可以在报表生成方法中找到。

错误499客户端关闭请求

当客户端在市场端完成请求处理之前关闭连接时，会返回错误。在客户端检查超时设置和请求重播策略并重复调用。

错误500内部服务器错误

等待一段时间，然后再次调用该方法。如果问题仍然存在，请联系客户支持。 — 前往 Urbanads内阁然后按下按钮 创建上诉.

503服务不可用错误

资料描述

翻译

怎么办

发生错误的方法

Service temporarily unavailable. Please, try again later

由于高负载,服务器暂时不可用.

尝试在一段时间后重复请求。

如果问题仍然存在，请联系客户支持。 — 前往 Urbanads内阁然后按下按钮 创建上诉.

它在所有方法中找到。

错误消息示例

请求:

POST v2/reports/shows-boost/generate HTTP/1.1
Host: api.urbanads.yandex.ru
Accept: */*
Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664a

回答:

{
  "errors": [
    {
      "code": "UNAUTHORIZED",
      "message": "Api-Key token is invalid"
    }
  ],
  "status": "ERROR"
}

这篇文章是否有用？

回应格式

请求的限制