---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.1
alternate:
  - https://yandex.com/support/market-distr/ru/api/concepts/error-codes.md
  - href: https://yandex.com/support/market-distr/ru/api/concepts/error-codes.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821
    rel: describedby
keywords: Сообщения об ошибках
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/market-distr/ru/llms.txt?revision=r22075821


# Сообщения об ошибках

В случае возникновения ошибки обработка запроса прекращается, сервер возвращает HTTP‑статус ответа, отражающий суть произошедшей ошибки. Кроме статуса в ответе передается краткое описание ошибки.

Сообщение об ошибке возвращается в формате JSON, если в URL запроса не указан параметр `format`.

Описание ошибок передается в параметре `errors`.

# Описание ошибок

#|
||
**HTTP‑статус**
|
**Текст ошибки**
|
**Пояснение**
||
||
``` 200 ```
|
``` OK ```
|
Запрос выполнен успешно.
||
||
``` 400 ```
|
``` Bad request ```
|
Запрос невалидный.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Bad request"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Bad request"/>
</errors>
```
||
||
^
|
``` request body is missing or invalid ```
|
Тело запроса не передано или передано некорректно.
||
||
^
|
``` clid is required in request body ```
|
В теле запроса не указан clid.
||
||
^
|
``` unexpected request body type ```
|
Передано тело запроса некорректного типа.
||
||
^
|
``` exactly one of url or partner_article is required ```
|
В запросе не передан url или partner_article.
||
||
^
|
``` url parameter is required ```
|
В запросе не передан url.
||
||
^
|
``` invalid partner_article format ```
|
Передан некорректный формат артикула.
||
||
``` 401 ```
|
```
Authorization failed: request
  from unknown IP address
  {IP} or invalid key
  or key suspended
  or key missing
```
|
Ошибка авторизации — в запросе не указаны [авторизационные данные](https://yandex.ru/support/market-distr/ru/api/concepts/authorization.md#getting-a-key) или они невалидны.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message":
      "Authorization failed: request from
      unknown IP address 0:0:0:0:0:0:0:0
      or invalid key or key suspended
      or key missing"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Authorization failed:
                 request from unknown
                 IP address
                 0:0:0:0:0:0:0:0
                 or invalid key or key
                 suspended or key
                 missing"/>
</errors>
```
||
||
^
|
``` oauth token is invalid or expired ```
|
Ошибка авторизации — в запросе не указаны авторизационные данные или они невалидны.
||
||
^
|
``` required parameter 'clid' or 'place_id' is missing ```
|
В запросе отсутствует обязательный параметр clid или place_id.
||
||
^
|
``` account not found by clid: {clid} ```
|
В запросе указан несуществующий clid.
||
||
^
|
``` account not found by place_id: {place_id} ```
|
В запросе указан несуществующий place_id.
||
||
^
|
``` place_id authorization is not supported for this path ```
|
Параметр place_id в этом запросе не может быть использован.
||
||
``` 403 ```
|
``` Forbidden resource ```
|
У вас нет доступа к этому ресурсу.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Forbidden resource"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Forbidden resource"/>
</errors>
```
||
||
^
|
``` oauth token owner does not match clid owner ```
|
Владелец clid не является владельцем токена авторизации.
||
||
^
|
``` ref does not belong to the authenticated account ```
|
Владелец токена авторизации не является владельцем переданной ссылки или артикула.
||
||
``` 404 ```
|
``` {objectName} not found ```
|
Указанный в запросе объект не найден.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Offer not found"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Offer not found"/>
</errors>
```
||
||
``` 405 ```
|
```
Request method
  '{method}'
  not supported
```
|
Используемый метод не поддерживается.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message":
      "Request method 'DELETE' not
      supported"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Request method 'DELETE'
                 not supported"/>
</errors>
```
||
||
``` 429 ```
|
``` Rate limit exceeded ```
|
Превышено одно или несколько [ограничений для запросов](https://yandex.ru/support/market-distr/ru/api/concepts/limits.md).

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Rate limit exceeded"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Rate limit exceeded"/>
</errors>
```
||
||
``` 499 ```
|
``` Client closes the connection ```
|
Клиент закрыл соединение, не дождавшись ответа от сервера.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Client closes the
               connection"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Client closes the
                 connection"/>
</errors>
```
||
||
``` 500 ```
|
``` Internal server error ```
|
На сервере произошла ошибка.

Пример сообщения для формата JSON:

```json
"errors":
[
  {
    "message": "Internal server error"
  }
]
```

Пример сообщения для формата XML:

```xml
<errors>
  <error message="Internal server error"/>
</errors>
```
||
|#