--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md - https://yandex.ru/dev/market/partner-api/doc/ru/concepts/error-codes.md - https://yandex.ru/dev/market/partner-api/doc/zh/concepts/error-codes.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/market/partner-api/doc/zh/llms.txt # 错误的类型以及如何处理它们 如果请求无法完成, 空气污染指数市区 返回响应中的参数 `errors`. 它包含错误代码（参数 `code`）及其简要说明（参数 `message`). ## 错误代码是什么意思？ {#codes} #| ||**密码**|**标题**|**发生了什么，该怎么做**|| ||[400](#400)| `Bad Request` | 请求内容有问题。 例如，JSON数据格式存在错误，或者您正在尝试更改已取消或已交付订单的状态。 专注于错误描述，以了解究竟是什么错误。|| ||[401](#401)| `Unauthorized` | 授权令牌未在请求中指定（或已指定，但不在那里）。|| ||[403](#403)| `Forbidden` | * 访问被拒绝：无效的授权数据或对资源没有权限。 * 另一个访问错误。 || ||[404](#404)| `Not Found` | * 找不到请求的方法或资源。 检查系统使用的请求地址。 || ||[405](#405)| `Method Not Allowed` | 在指定的资源上没有这样的方法。 检查系统使用的请求地址。|| ||[415](#415)| `Unsupported Media Type` | 方法不支持所请求的内容类型。 检查请求的正确性。|| ||[420](#420)| `Enhance Your Calm` | 已超出请求限制。 确保您的系统不会发送任何多余的内容。|| ||[499](#499)| `Client Closed Request` | 客户端在侧处理请求之前关闭了连接。 都市人 . 检查客户端的超时并重复请求。|| ||[500](#500)| `Internal Server Error` | 内部错误 都市人 .|| ||[503](#503)| `Service Unavailable` | 服务器 都市人 超载。|| |# ## 查询内容中的错误(400) {#400} ### 在所有方法中发现的错误 {#common} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**'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`. [详细了解输入数据格式](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/input-format.md) | 它在所有方法中找到。 || ||**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未经授权的错误 {#401} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Api-Key token is invalid** | Api-Key-令牌无效。 | 检查拼写 Api-Key-令牌。 如果错误仍然存在，请获取新令牌。 [怎么做](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md) | 它在所有方法中找到。 || ||**Api-Key token is not specified** | 请求没有指定 Api-Key-令牌。 | 传下去 Api-Key-标题中的标记 `Api-Key` 由 [指示说明](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md#use). | 它在所有方法中找到。 || ||**Api-Key token length invalid** | 长度不正确 Api-Key-令牌。 | 检查拼写 Api-Key-令牌。 如果错误仍然存在，请获取新令牌。 [怎么做](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md) | 它在所有方法中找到。 || ||**Api-Key token prefix invalid** | 前缀不正确 Api-Key-令牌。 | 确保在标头中不使用前缀。 `Bearer`. [如何传送 Api-Key-令牌](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md#use) 如果没有前缀，请检查拼写。 Api-Key-令牌。 如果错误仍然存在，请获取新令牌。 [怎么做](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md) | 它在所有方法中找到。 || ||**Api-Key token format invalid** | 格式不正确 Api-Key-令牌。 | 检查拼写 Api-Key-令牌。 如果错误仍然存在，请获取新令牌。 [怎么做](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md) | 它在所有方法中找到。 || ||**Api-Key token is revoked** | Api-Key-令牌已被删除。 | 获得一个新的令牌。 [怎么做](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/api-key.md) | 它在所有方法中找到。 || |# ## 403禁止的错误 {#403} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Access denied** | 访问被拒绝。 | 检查是否正确指定了资源，以及在请求中使用其授权令牌的用户是否具有对其的访问权限。 [有关access的更多信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/oauth-2.0.md) | 它在所有方法中找到。 || ||**The method is deprecated and is occasionally forbidden. Please stop using it** | 该方法已经过时，并且对其的一些请求被拒绝。 不要用它。 | 切换到文档中指定的当前方法。 错误将返回给继续调用过时方法的集成；此类响应的比例会随着时间的推移而增加。 | 它在所有方法中找到。 || |# ## 404未找到错误 {#404} #| ||**Report not found.** | 未找到请求中指定的报告或文档。 | 检查报告或文档的传输ID的正确性。 | [GET v2/reports/info/{reportId}](https://yandex.ru/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md) || ||**Resource not found** | 找不到资源。 | * 检查准确性 URL 和HTTP方法，它们可以在方法页面的文档中查看。 * 确保您使用的是正确版本的方法。 [了解有关调用方法的详细信息](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/method-call.md) | 它在所有方法中找到。 || |# ## 错误405方法不允许 {#405} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Request method 'method' not supported** | 不支持请求的HTTP方法。 | 检查资源支持的方法。 | 它在所有方法中找到。 || |# ## 错误415不支持的媒体类型 {#415} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Content type 'content-type' not supported** | 不支持请求的内容类型。 | 送所支持的内容类型之一。 | 它在所有方法中找到。 || ||**Unknown content-type: 'content-type'** | 请求的内容类型 — 未知。 | 送所支持的内容类型之一。 | 它在所有方法中找到。 || |# ## 错误420增强你的冷静 {#420} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Hit rate limit of 'N' parallel requests for {entity}** | 超过了同时向 Yandex Market API. [这是什么](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/limits.md#global) | 将特定实体的并行API请求数量减少到 `N` 请求。 | 它在所有方法中找到。 || ||**Hit rate limit of 'N' requests per 'period' for resource 'R' for {entity}** | 超过资源限制的数目 `N` 资源请求 `R` 期间 `period` 为特定实体。 [这是什么](https://yandex.ru/dev/market/partner-api/doc/zh/concepts/limits.md#resource)| 时间限制在标题中指定。 `X-RateLimit-Resource-Until`. 该资源的使用将在指定时间之后成为可能。 | 它在所有方法中找到。 || ||**Active reports limit exceeded, limit='limit'** | 已超过同时生成的报告数量的限制。 | 在创建新报告之前，请等待生成以前的报告。 同一时间生成的报告数量取决于您的数据计划。 阅读更多关于卖家订阅的信息 [在市场对卖家的帮助](https://yandex.ru/support/marketplace/ru/marketing/subscription). | 它可以在报表生成方法中找到。 || |# ## 错误499客户端关闭请求 {#499} 当客户端在市场端完成请求处理之前关闭连接时，会返回错误。 在客户端检查超时设置和请求重播策略并重复调用。 ## 错误500内部服务器错误 {#500} 等待一段时间，然后再次调用该方法。 如果问题仍然存在，请联系客户支持。 — 前往 [Urbanads内阁](https://urbanads.yandex.ru/business/any/support) 然后按下按钮 **创建上诉**. ## 503服务不可用错误 {#503} #| ||**资料描述**|**翻译**|**怎么办**|**发生错误的方法**|| ||**Service temporarily unavailable. Please, try again later** | 由于高负载,服务器暂时不可用. | 尝试在一段时间后重复请求。 如果问题仍然存在，请联系客户支持。 — 前往 [Urbanads内阁](https://urbanads.yandex.ru/business/any/support) 然后按下按钮 **创建上诉**. | 它在所有方法中找到。 || |# ## 错误消息示例 {#example} 请求: ```httpget translate=no POST v2/reports/shows-boost/generate HTTP/1.1 Host: api.urbanads.yandex.ru Accept: */* Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664a ``` 回答: ```json translate=no { "errors": [ { "code": "UNAUTHORIZED", "message": "Api-Key token is invalid" } ], "status": "ERROR" } ```