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

如果商店的请求无法完成，市场将返回参数作为响应。 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`	该方法不能用于此存储。专注于错误描述，以了解究竟是什么错误。
500	`Internal Server Error`	Yandex的内部错误。市场。
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 revoked	Api-Key-令牌已被删除。	获得一个新的令牌。怎么做
Api-Key token format invalid	格式不正确 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-令牌。如果错误仍然存在，请获取新令牌。怎么做
Authorization header has invalid syntax	HTTP头格式 `Authorization` 不正确。	通过以下方式制作标题指示说明.
Credentials are not specified	请求中未指定授权数据。	根据说明制作标题: Api-Key-令牌 OAuth令牌
OAuth credentials are not specified	请求中未指定授权数据。	做一个标题 `Authorization` 由指示说明.
OAuth token is not specified	请求未指定OAuth授权令牌。	做一个标题 `Authorization` 由指示说明.
Unsupported authorization type specified in Authorization header	HTTP头中传输的授权类型 `Authorization`，不支持。	通过以下方式制作标题指示说明.

403禁止的错误

资料描述	翻译	怎么办
Access denied	访问被拒绝。	检查是否正确指定了资源，以及在请求中使用其授权令牌的用户是否具有对其的访问权限。有关access的更多信息
Access denied for campaign 'campaignId' because it is not active	由于[存储不活动]，该方法不可用(*inactiv-campaign).	使用API的选项显示参数 `apiAvailability` 回应要求: GET v2/campaigns; GET v2/campaigns/{campaignId}. 修复阻止商品退回展柜的错误。如果您需要API访问权限，请联系客户支持。 — 前往卖方在市场上的帐户然后按下按钮创建上诉.
Access to API denied for the client / campaign	使用 Yandex Market API 禁止卖家使用。	请与您的代理机构联系,以提供对API的访问.
Contact not found for login 'login' and campaignId 'campaignId'	未找到其登录名已发送以签署电子验收证书的用户帐户。	选择链接到帐户或商店的用户的用户名。
Contacts with available roles for signing not found for login 'login'	其登录被转移以签署电子接受证书的用户帐户不具有必要的访问权限。	提供链接到帐户或商店并具有必要访问权限的用户的用户名。软件方法的访问Api-Key
OAuth token is invalid	指定的OAuth授权令牌无效。	获得一个新的令牌。怎么做
OAuth token is invalid (account has been globally logged out)	用户使用的功能 "到处出去" 在Yandex的ID。	获得一个新的令牌。怎么做
Restrict access for business 'businessId' because it is not active	由于[帐户不活动]，该方法不可用(*inactiv-business).	修复阻止商品退回展柜的错误。如果您需要API访问权限，请联系客户支持。 — 前往卖方在市场上的帐户然后按下按钮创建上诉.
Scope is invalid	OAuth令牌是通过应用程序获得的，没有进入市场。	获得一个新的令牌。怎么做
The method is not supported for Market Yandex Go sellers	此方法不适用于Yandex Go市场卖家。这些限制在方法的描述中指定。	—
Token does not have any of the scopes to access the API method	无法访问该方法。	获取对错误文本中列出的至少一组方法的访问权限。怎么做
User account is disabled	将阻止为其颁发指定授权令牌的用户的帐户。	联系客户支持。

404未找到错误

资料描述	翻译	怎么办
Campaign not found: 'campaignId'	未找到请求中指定的活动。	检查传输的广告系列ID是否正确。
Login not found: 'login'	未找到请求中指定的用户名。	检查传输的用户名的正确性。
Model not found: 'modelId'	未找到请求中指定的模型。	检查传输的型号ID是否正确。

错误405方法不允许

资料描述	翻译	怎么办
Request method 'method' not supported	不支持请求的HTTP方法。	检查资源支持的方法。

错误415不支持的媒体类型

资料描述	翻译	怎么办
Content type 'content-type' not supported	不支持请求的内容类型。	传输所支持的内容类型之一。
Missing Content-Type	未指定内容类型。	传递内容类型。
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	橱柜使用所有商店的价格。	您将无法为单独的商店设置价格。为橱柜中的所有商店设置统一的价格。

错误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"
}

这篇文章是否有用？

回应格式

请求的限制