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

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

Сообщение об ошибке возвращается в том формате, который указан в URL запроса после имени метода или в HTTP-заголовке Accept.

Описание ошибки передается в параметре errors. Данный параметр содержит код ошибки (параметр code) и краткое описание ошибки (параметр message).

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

Код Название Пояснение
200 OK Запрос выполнен успешно.
400 Bad Request Запрос невалидный.
401 Unauthorized В запросе не указаны авторизационные данные.
403 Forbidden Неверны авторизационные данные, указанные в запросе, или запрещен доступ к запрашиваемому ресурсу.
404 Not Found Запрашиваемый ресурс не найден.
405 Method Not Allowed Запрашиваемый метод для указанного ресурса не поддерживается.
429 Too Many Requests Превышено ограничение на количество запросов или на доступ к ресурсу.
500 Internal Server Error Внутренняя ошибка сервера. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу поддержки поиска по товарам.
503 Service Unavailable Сервер временно недоступен из-за высокой загрузки. Попробуйте вызвать метод через некоторое время.

Краткое описание ошибки в ответе

  • Для ошибки 400 Bad Request:

    Описание Пояснение Способ возможного решения
    Request body is not json В формате JSON-данных содержится ошибка. Проверьте корректность JSON-формата данных, передаваемых в теле запроса.

    Причины, которые могут содержаться в сообщениях о данной ошибке, приведены в описаниях соответствующих ресурсов.

  • Для ошибки 401 Unauthorized:

    Описание Пояснение Способ возможного решения
    Wrong authorization format or empty oauth token Не передан заголовок Authorization или передан в некорректном формате. Проверьте корректность авторизационных данных.
    OAuth token is invalid Токен некорректен или отозван.

  • Для ошибки 403 Forbidden:

    Описание Пояснение Способ возможного решения
    Your oauth client must have scope products:partner_api Для токена не получен необходимый доступ к данным. Проверьте корректность авторизационных данных.
    Your login {login} doesn't have access to feed {feedId} От логина нет доступа к указанному фиду. Проверьте список доступных вам фидов.

  • Для ошибки 405 Method Not Allowed:

    Описание Пояснение Способ возможного решения
    Request method 'method' not supported Запрашиваемый HTTP-метод не поддерживается. Проверьте методы, которые поддерживаются ресурсом. Список всех методов приведен в разделе [!TITLE getting-started.md].

  • Для ошибки 429 Too many requests:

    Описание Пояснение Способ возможного решения
    Limiter quota {quotaName} exceeded. {описание ограничений соответствующей квоты} Превышено ограничение на количество запросов. Перепроверьте ограничения запросов.

  • Для ошибки 503 Service Unavailable:

    Описание Пояснение Способ возможного решения
    Service temporarily unavailable. Please, try again later Сервер временно недоступен из-за высокой загрузки. Попробуйте повторить запрос через некоторое время.

Пример сообщения об ошибке

Пример запроса:

GET /products/api/ext/partner/feeds-info HTTP/1.1
Host: yandex.ru
Accept: */*
Authorization: OAuth some_invalid_token

Пример ответа:

{
   'http_code': 401,
   'status': 'ERROR',
   'errors': [{'code': 'UNAUTHORIZED', 'message': 'OAuth token is invalid'}]
}
Предыдущая
Формат входных данных и ответа
Следующая
Ограничения для запросов