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

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

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

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

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

HTTP‑статус

Текст ошибки

Пояснение

200

OK

Запрос выполнен успешно.

400

Bad request

Запрос невалидный.

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

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

Пример сообщения для формата 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

Ошибка авторизации — в запросе не указаны авторизационные данные или они невалидны.

Пример сообщения для формата 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:

<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:

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

Пример сообщения для формата 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:

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

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

<errors>
  <error message="Offer not found"/>
</errors>

405

Request method
  '{method}'
  not supported

Используемый метод не поддерживается.

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

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

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

<errors>
  <error message="Request method 'DELETE'
                 not supported"/>
</errors>

429

Rate limit exceeded

Превышено одно или несколько ограничений для запросов.

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

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

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

<errors>
  <error message="Rate limit exceeded"/>
</errors>

499

Client closes the connection

Клиент закрыл соединение, не дождавшись ответа от сервера.

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

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

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

<errors>
  <error message="Client closes the
                 connection"/>
</errors>

500

Internal server error

На сервере произошла ошибка.

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

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

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

<errors>
  <error message="Internal server error"/>
</errors>