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

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

如果某个代码有太多错误,您将在您的帐户中收到有关它的通知。

错误代码是什么意思?

密码

标题

发生了什么,该怎么做

400

糟糕的要求

请求内容有问题。 例如,JSON数据格式存在错误,或者您正在尝试更改已取消或已交付订单的状态。

专注于错误描述,以了解究竟是什么错误。

401

Unauthorized

授权令牌未在请求中指定(或已指定,但不在那里)。

403

Forbidden

  • 授权令牌不起作用。 对于OAuth令牌: 最有可能的是,它已经过期,或者您已经从工作人员中删除了为其颁发令牌的人。
  • 由于以下原因,API方法不可用 商店或橱柜的不活动.
  • 另一个访问错误。

404

未找到

  • 找不到请求的资源。 检查商店系统使用的请求地址。
  • 未找到指定的参数。 例如,广告系列。 检查传输数据的正确性。

405

不允许的方法

在指定的资源上没有这样的方法。

检查商店系统使用的请求地址。

415

不支持的媒体类型

方法不支持所请求的内容类型。

检查请求的正确性。

420

增强你的平静

商店超出了请求限制。

确保您的系统不会发送任何多余的内容。

423

Locked

该方法不能用于此存储。

专注于错误描述,以了解究竟是什么错误。

500

内部服务器错误

Yandex的内部错误。 市场。

503

服务不可用

的Yandex。市场服务器过载。

查询内容中的错误(400)

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

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

资料描述

翻译

怎么办

不允许使用活动类型

此方法不支持商店的运营模式。

确保使用支持商店运营模式的方法。

字段集合不能为空

参数不能为空。

为参数指定至少一个元素。

与该机构签订了类型营销合同

营销合同已与该机构签订。

有关结案文件的信息,请与贵机构联系.

无效状态:'状态'

指定了不正确的状态。

检查传输状态的正确性,以按状态过滤订单。

JSON:{消息}

JSON数据格式包含错误。

检查JSON的正确性。

超过限额

超过每页参数值数的限制 limit.

值的数量减少。

缺少字段

未指定必需参数。

指定所需参数的值。

出口被禁用由合作伙伴编辑

您不能更改信息或删除商店的销售点,因为您拒绝交付到市场的提货点。 阅读更多有关星展商店的送货规则。 在市场对卖家的帮助.

如果您准备好将产品交付到市场的提货点,请联系客户支持。

根据ISO3166-1alpha-2,字符串(值)不是有效的国家/地区代码

无效的国家代码。

以ISO3166-1alpha-2格式指定国家/地区代码。

请求太大:{消息}

已超过HTTP请求大小限制。

内容的大小不能超过512KB。 将请求分成几个。

过长的时间段。 最大是"最大周期"天数

日期范围过大。 最大射程 — maxPeriod.

缩小日期范围以按日期筛选订单。

意外字符"字符":期望一个有效的值"值"

无效字符。

检查请求体的编码。 所需的编码是UTF-8。

内容意外结束

请求体意外结束。

检查请求体中传输的数据的格式的正确性。

字段的值/长度(值)必须在最小和最大之间[独占]

参数的值(长度)必须介于两个值之间 minmax 它并不等于他们。

检查参数值的正确性。

字段(值)的值/长度必须大于/小于[或等于]限制

参数的值(长度)必须等于或大于(小于)指定的值。 limit.

检查参数值的正确性。

Field的价值规模太大:'price'

精度设置过高的参数。

少精度设置参数值。

字段的值必须匹配模式:'regExp'

参数值必须与正则表达式匹配。

检查参数值的正确性。

401未经授权的错误

资料描述

翻译

怎么办

Api-Key令牌无效

Api密钥令牌无效。

检查Api密钥令牌的拼写。 如果错误仍然存在,请获取新令牌。 怎么做

Api-Key令牌被撤销

Api密钥令牌已被删除。

获得一个新的令牌。 怎么做

Api-Key令牌格式无效

Api密钥令牌格式不正确。 令牌的前缀和长度是正确的。

检查Api密钥令牌的拼写。 如果错误仍然存在,请获取新令牌。 怎么做

Api-密钥令牌长度无效

Api密钥令牌的长度不正确。

检查Api密钥令牌的拼写。 如果错误仍然存在,请获取新令牌。 怎么做

Api-Key令牌前缀无效

Api密钥令牌的前缀不正确。

确保在标头中不使用前缀。 Bearer. 如何传输Api密钥令牌

如果没有前缀,请检查Api密钥令牌的拼写。 如果错误仍然存在,请获取新令牌。 怎么做

授权标头语法无效

HTTP头格式 Authorization 不正确。

通过以下方式制作标题 指示说明.

未指定凭据

请求中未指定授权数据。

根据说明制作标题:

未指定OAuth凭据

请求中未指定授权数据。

做一个标题 Authorization指示说明.

未指定OAuth令牌

请求未指定OAuth授权令牌。

做一个标题 Authorization指示说明.

授权标头中指定的不支持的授权类型

HTTP头中传输的授权类型 Authorization,不支持。

通过以下方式制作标题 指示说明.

403禁止的错误

资料描述

翻译

怎么办

拒绝进入

访问被拒绝。

检查是否正确指定了资源,以及在请求中使用其授权令牌的用户是否具有对其的访问权限。 有关access的更多信息

竞选"竞选"被拒绝,因为它不活跃

该方法是不可用的,由于 商店不活动.

使用API的选项显示参数 apiAvailability 回应要求:

修复阻止商品退回展柜的错误。 如果您需要为此访问API,请联系支持。 前往 卖方在市场上的帐户 然后按下按钮 创建上诉.

拒绝客户/活动使用空气污染指数

禁止卖家访问Yandex Market API。

请与您的代理机构联系,以提供对API的访问.

未找到登录"登录"和campaignId"campaignId"的联系人

未找到其登录名已发送以签署电子验收证书的用户帐户。

选择链接到帐户或商店的用户的用户名。

未找到用于登录"登录"的可用角色的联系人

其登录被转移以签署电子接受证书的用户帐户不具有必要的访问权限。

提供链接到帐户或商店并具有必要访问权限的用户的用户名。 通过Api密钥访问方法

OAuth令牌无效

指定的OAuth授权令牌无效。

获得一个新的令牌。 怎么做

OAuth令牌无效(帐户已全局注销)

用户使用的功能 "到处出去" 在Yandex的ID。

获得一个新的令牌。 怎么做

限制business'businessId'的访问权限,因为它不活动

该方法是不可用的,由于 内阁不活动.

修复阻止商品退回展柜的错误。 如果您需要为此访问API,请联系支持。 前往 卖方在市场上的帐户 然后按下按钮 创建上诉.

范围无效

OAuth令牌是通过应用程序获得的,没有进入市场。

获得一个新的令牌。 怎么做

该方法不适用于市场Yandex Go卖家

此方法不适用于Yandex Go市场卖家。

这些限制在方法的描述中指定。

令牌没有任何范围来访问API方法

无法访问该方法。

获取对错误文本中列出的至少一组方法的访问权限。 怎么做

用户帐户被禁用

将阻止为其颁发指定授权令牌的用户的帐户。

联系客户支持。

404未找到错误

资料描述

翻译

怎么办

活动未找到:"活动"

未找到请求中指定的活动。

检查传输的广告系列ID是否正确。

未找到登入:"登入"

未找到请求中指定的用户名。

检查传输的用户名的正确性。

未找到模型:'modelId'

未找到请求中指定的模型。

检查传输的模型ID是否正确。

错误405方法不允许

资料描述

翻译

怎么办

不支持请求方法"方法"

不支持请求的HTTP方法。

检查资源支持的方法。

错误415不支持的媒体类型

资料描述

翻译

怎么办

不支持内容类型"内容类型"

不支持请求的内容类型。

传输所支持的内容类型之一。

缺少内容类型

未指定内容类型。

传递内容类型。

未知内容类型:"内容类型"

请求的内容类型未知。

传输所支持的内容类型之一。

错误420增强你的冷静

资料描述

翻译

怎么办

"N"个并行请求的命中率限制

对Yandex的同时请求数量的全局限制。卖家的市场API已被超过。 这是什么

减少单个机柜或存储中的并行API请求数量,以 N 请求。

资源"R"每"周期"n"请求的命中率限制

超过资源限制的数目 N 资源请求 R 期间 period 对于同一个办公室或商店。 这是什么

时间限制在标题中指定。 X-RateLimit-Resource-Until. 该资源的使用将在指定时间之后成为可能。

错误423锁定

资料描述

翻译

怎么办

业务在迁移

商店迁移正在内阁中进行。

等待传输完成。

运动是在业务迁移

商店正在被转移到另一个帐户。

等待传输完成。

合作伙伴仅使用默认价格

橱柜使用所有商店的价格。

您将无法为单独的商店设置价格。 为橱柜中的所有商店设置统一的价格。

错误500内部服务器错误

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

503服务不可用错误

资料描述

翻译

怎么办

服务暂时不可用。 请稍后再试

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

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

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

错误消息示例

请求:

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

Магазин отключен, так как не размещал товары на витрине больше 90 дней.

В кабинете нет ни одного активного магазина.

Магазин отключен, так как не размещал товары на витрине больше 90 дней.

В кабинете все магазины отключены, так как не размещали товары на витрине больше 90 дней.

上一篇