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

如果商店的请求无法完成，市场将返回参数作为响应。 errors. 它包含错误代码（参数 code）及其简要描述（参数 message).

如果某个代码有太多错误，您将在市场上的卖家帐户中收到有关此的通知。

错误代码是什么意思？

密码	标题	发生了什么，该怎么做
400	`Bad Request`	请求内容有问题。例如，JSON数据格式存在错误，或者您正在尝试更改已取消或已交付订单的状态。专注于错误描述，以了解究竟是什么错误。
401	`Unauthorized`	授权令牌未在请求中指定（或已指定，但不在那里）。
403	`Forbidden`	授权令牌不起作用。对于OAuth令牌: 最有可能的是，它已经过期，或者您已经从工作人员中删除了为其颁发令牌的人。由于[商店或橱柜不活动]，API方法不可用(*inactivity). 另一个访问错误。
404	`Not Found`	找不到请求的方法或资源。检查商店系统使用的请求地址。未找到指定的参数。例如，广告系列。检查传输数据的正确性。未找到方法版本。检查您使用的版本是否正确。
405	`Method Not Allowed`	在指定的资源上没有这样的方法。检查商店系统使用的请求地址。
415	`Unsupported Media Type`	方法不支持所请求的内容类型。检查请求的正确性。
420	`Enhance Your Calm`	商店超出了请求限制。确保您的系统不会发送任何多余的内容。
423	`Locked`	该方法不能用于此存储。专注于错误描述，以了解究竟是什么错误。
499	`Client Closed Request`	客户端在完成市场端的请求处理之前关闭了连接。检查客户端的超时并重复请求。
500	`Internal Server Error`	市场的内部错误。
503	`Service Unavailable`	的Yandex。市场服务器过载。

查询内容中的错误(400)

此错误的可能原因取决于特定请求。在许多查询的描述中，有一节描述了特定数据的400错误选项。

400代码的一些错误变体对于不同的查询是相同的:

资料描述	翻译	怎么办
Campaign type is not allowed	此方法不支持商店的运营模式。	确保使用支持商店运营模式的方法。
Collection of field must not be empty	参数不能为空。	为参数指定至少一个元素。
Contract with type MARKETING was signed with the agency	营销合同已与该机构签订。	有关结案文件的信息,请与贵机构联系.
Invalid status: 'status'	指定了不正确的状态。	检查传输状态的正确性，以按状态过滤订单。
JSON: {message}	JSON数据格式包含错误。	检查JSON的正确性。
Limit exceeded	已超过每页值数的限制 — 参数 `limit`.	值的数量减少。
Missing field	未指定必需参数。	指定所需参数的值。
Outlet is disabled for editing by partner	您不能更改信息或删除商店的销售点，因为您拒绝交付到市场的提货点。了解有关以下运输规则的更多信息 DBS-阅读商店在市场对卖家的帮助.	如果您准备好将产品交付到市场上的提货点，请联系客户支持。
String (value) is not a valid country code according to ISO 3166-1 alpha-2	无效的国家代码。	以ISO3166-1alpha-2格式指定国家/地区代码。
The request is too big: {message}	已超过HTTP请求大小限制。	内容的大小不能超过512KB。将请求分成几个。
Too long time period. Maximum is 'maxPeriod' days	日期范围过大。最大射程 — `maxPeriod`.	缩小日期范围以按日期筛选订单。
Unexpected character 'character': expected a valid value 'values'	无效字符。	检查请求体的编码。所需编码 — UTF-8。
Unexpected end of content	请求体意外结束。	检查请求体中传输的数据的格式的正确性。
Value / length of field (value) must be between min and max [exclusively]	参数的值（长度）必须介于两个值之间 `min` 和 `max` 它并不等于他们。	检查参数值的正确性。
Value / length of field (value) must be greater / less than [or equal to limit]	参数的值（长度）必须等于或大于（小于）指定的值。 `limit`.	检查参数值的正确性。
Value of field has too high scale: 'price'	精度设置过高的参数。	少精度设置参数值。
Value of field must match the pattern: 'regExp'	参数值必须与正则表达式匹配。	检查参数值的正确性。

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-令牌已被删除。	获得一个新的令牌。怎么做
Authorization header has invalid syntax	HTTP头格式 `Authorization` 不正确。	通过以下方式制作标题指示说明.
Credentials are not specified	请求中未指定授权数据。	根据说明制作标题: Api-Key-令牌 OAuth令牌
OAuth client id is not specified	请求未指定OAuth客户端ID（`client_id`).	指定 `client_id` 标题中的应用程序 `oauth_client_id`.
OAuth credentials are not specified	请求中未指定授权数据。	做一个标题 `Authorization` 由指示说明.
OAuth token is not specified	请求未指定OAuth授权令牌。	做一个标题 `Authorization` 由指示说明.

403禁止的错误

资料描述	翻译	怎么办
Access denied	访问被拒绝。	检查是否正确指定了资源，以及在请求中使用其授权令牌的用户是否具有对其的访问权限。有关access的更多信息
Access denied for business 'businessId' because it is not active	由于[帐户不活动]，该方法不可用(*inactiv-business).	修复阻止商品退回展柜的错误。如果您需要API访问权限，请联系客户支持。 — 前往卖方在市场上的帐户然后按下按钮创建上诉.
Access denied for campaign 'campaignId' because it is not active	由于[存储不活动]，该方法不可用(*inactiv-campaign).	使用API的选项显示参数 `apiAvailability` 回应要求: GET v2/campaigns; GET v2/campaigns/{campaignId}. 修复阻止商品退回展柜的错误。如果您需要API访问权限，请联系客户支持。 — 前往卖方在市场上的帐户然后按下按钮创建上诉.
Client id is invalid	指定了无效的OAuth客户端ID（`client_id`).	指定 `oauth_client_id` 发出令牌的相同应用程序，或将令牌重新发出给所需的客户端。
Contact not found for login 'login' and campaignId 'campaignId'	未找到其登录名已发送以签署电子验收证书的用户帐户。	选择链接到帐户或商店的用户的用户名。
Contacts with available roles for signing not found for login 'login'	其登录被转移以签署电子接受证书的用户帐户不具有必要的访问权限。	提供链接到帐户或商店并具有必要访问权限的用户的用户名。软件方法的访问Api-Key
Electronic signature is only available for API token authorization.	电子签名只有在获得授权时才可用 Api-Key.	通过授权提出请求 Api-Key. 如何传送 Api-Key: 手册.
No access to campaigns: 'campaigns'	无法访问指定的商店。	仅发送属于指定帐户的广告系列（`businessId`).
No access to comment modifying.	没有编辑指定注释的权限。	检查传输的评论ID的正确性。
No access to feedback modifying.	没有权限修改指定的审核。	检查传送的审查ID的正确性。
OAuth token is invalid	指定的OAuth授权令牌无效。	获得一个新的令牌。怎么做
OAuth token is invalid (account has been globally logged out)	用户使用的功能 "到处出去" 在Yandex的ID。	获得一个新的令牌。怎么做
Scope is invalid	OAuth令牌是通过应用程序获得的，没有进入市场。	获得一个新的令牌。怎么做
The method is deprecated and is occasionally forbidden. Please stop using it	该方法已经过时，并且对其的一些请求被拒绝。不要用它。	切换到文档中指定的当前方法。错误将返回给继续调用过时方法的集成；此类响应的比例会随着时间的推移而增加。
The method is not supported for Market Yandex Go sellers	此方法不适用于Yandex Go市场卖家。这些限制在方法的描述中指定。	—
The partner does not have access to the supply request.	合作伙伴无权访问交付请求。	检查传输的应用程序ID的正确性。
Token does not have any of the scopes to access the API method	无法访问该方法。	获取对错误文本中列出的至少一组方法的访问权限。怎么做
User account is disabled	将阻止为其颁发指定授权令牌的用户的帐户。	联系客户支持。

404未找到错误

资料描述	翻译	怎么办
Box not found. Box: 'boxId'	未找到请求中指定的框。	检查传输的盒子ID是否正确。
Campaign not found 'campaignId'	未找到请求中指定的活动。	检查传输的广告系列ID是否正确。
Can't find chat by id: 'chatId'	未找到请求中指定的聊天。	检查传输的聊天ID的正确性。
Can't find message by id: 'messageId' for chat 'chatId'	在传输的聊天中未找到请求中指定的消息。	检查传输的消息和聊天Id的正确性。
Failed to find ['resource'] with id ['id']	未找到请求中指定的资源。	检查传输的资源标识符（订单或装运）的正确性。
Failed to find order with id 'orderId'	未找到请求中指定的顺序。	检查传输的订单ID的正确性。
Feedbacks not found.	未找到请求中指定的评论。	检查传输的审核Id是否正确。
Grade not found.	没有找到审查。	检查传送的审查ID的正确性。
No boxes found for order 'orderId'	未找到请求中指定的订单的框。	检查传输的订单ID的正确性。确保您提供了有关货物如何在盒子中分配的信息。为此，请使用以下方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.
Order not found: 'orderId'	未找到请求中指定的顺序。	检查传输的订单ID的正确性。
Order not found: partnerId = 'partnerId', orderId = 'orderId'	未找到请求中指定的顺序。	检查传输的订单ID的正确性。
Outlet not found: 'outletId'	未找到请求中指定的销售点。	检查传输的销售点标识符的正确性。
Region 'regionId' not found.	未找到请求中指定的区域。	检查传输的区域ID是否正确。要获取所有可用区域的列表，请使用引用方法 GET v2/regions
Report not found.	未找到请求中指定的报告或文档。	检查报告或文档的传输ID的正确性。
Resource not found	找不到资源。	检查准确性 URL 和HTTP方法，它们可以在方法页面的文档中查看。确保您使用的是正确版本的方法。了解有关调用方法的详细信息
Return 'returnId' for order 'orderId' is not found	未找到请求中指定的退款。	检查传输的退款和订单Id的正确性。
Shipment with ID 'shipmentId' not found	未找到请求中指定的装运。	检查传送的货件ID的正确性。
Supply request not found.	未找到该应用程序。	检查传输的应用程序ID的正确性。
Unknown category	未知类别。	检查传输的类别ID是否正确。要找出您感兴趣的产品所属类别的ID，请使用请求 POST v2/categories/tree.

错误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	超过了同时向 Yandex Market API 对于卖家。这是什么	减少单个机柜或存储中的并行API请求数量，以 `N` 请求。
Hit rate limit of 'N' requests per 'period' for resource 'R'	超过资源限制的数目 `N` 资源请求 `R` 期间 `period` 对于同一个办公室或商店。这是什么	时间限制在标题中指定。 `X-RateLimit-Resource-Until`. 该资源的使用将在指定时间之后成为可能。

错误423锁定

资料描述	翻译	怎么办
Business is in migration	商店迁移正在内阁中进行。	等待传输完成。
Campaign is in business migration	商店正在转移到另一个帐户。	等待传输完成。
Partner use only default price	橱柜使用所有商店的价格。	您将无法为单独的商店设置价格。为橱柜中的所有商店设置统一的价格。

错误499客户端关闭请求

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

错误500内部服务器错误

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

503服务不可用错误

资料描述

翻译

怎么办

Service temporarily unavailable. Please, try again later

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

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

如果问题仍然存在，请联系客户支持。 — 前往卖方在市场上的帐户然后按下按钮 创建上诉.

错误消息示例

请求:

GET /campaigns/10003/orders HTTP/1.1
Host: api.partner.market.yandex.ru
Accept: */*
Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664a

回答:

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

这篇文章是否有用？

回应格式

请求的限制