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

  1. Описание ошибок
  2. Краткое описание ошибки в ответе
  3. Пример сообщения об ошибке

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

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

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

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

Код

Название

Пояснение

200

OK

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

206

Partial Content

Запрос выполнен частично.

400

Bad Request

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

401

Unauthorized

В запросе не указаны авторизационные данные.

403

Forbidden

Неверны авторизационные данные, указанные в запросе, или запрещен доступ к запрашиваемому ресурсу.

404

Not Found

Запрашиваемый ресурс не найден.

405

Method Not Allowed

Запрашиваемый метод для указанного ресурса не поддерживается.

415

Unsupported Media Type

Запрашиваемый тип контента не поддерживается методом.

420

Enhance Your Calm

Превышено ограничение на доступ к ресурсу.

500

Internal Server Error

Внутренняя ошибка сервера. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу технической поддержки Яндекс.Маркета.

503

Service Unavailable

Сервер временно недоступен из-за высокой загрузки. Попробуйте вызвать метод через некоторое время.

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

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

    Описание

    Пояснение

    Способ возможного решения

    Collection of field must not be empty

    Параметр не должен быть пустым.

    Укажите хотя бы один элемент для параметра.

    Invalid status: 'status'

    Указан некорректный статус.

    Проверьте корректность передаваемого статуса для фильтрации заказов по статусу.

    JSON: {message}

    В формате JSON-данных содержится ошибка.

    Проверьте корректность JSON-формата данных, передаваемых в теле запроса.

    Missing field

    Не указан обязательный параметр.

    Укажите значение для обязательного параметра.

    The request is too big

    Превышено ограничение на размер HTTP-запроса.

    Уменьшите размер запроса, сократив количество передаваемых данных.

    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'

    Значение параметра должно соответствовать регулярному выражению.

    Проверьте корректность значения параметра.

    XML: {message}

    В формате XML-данных содержится ошибка.

    Проверьте корректность XML-формата данных, передаваемых в теле запроса.

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

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

    Описание

    Пояснение

    Способ возможного решения

    Unsupported authorization type specified in Authorization header

    Тип авторизации, переданный в HTTP-заголовке Authorization, не поддерживается.

    Проверьте корректность авторизационных данных.

    Authorization header has invalid syntax

    Формат HTTP-заголовка Authorization некорректен.

    Проверьте корректность авторизационных данных.

    OAuth credentials are not specified

    В запросе не указаны авторизационные данные.

    Проверьте корректность авторизационных данных.

    OAuth token is not specified

    В запросе не указан авторизационный токен (параметр oauth_token).

    Проверьте корректность авторизационных данных.

    OAuth client id is not specified

    В запросе не указан идентификатор приложения (параметр oauth_client_id).

    Проверьте корректность авторизационных данных.

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

    Описание

    Пояснение

    Способ возможного решения

    Access denied

    Доступ к указанному ресурсу запрещен.

    Проверьте правильность указания ресурса, а также наличие прав доступа к нему у авторизованного логина пользователя.

    Access to API denied for the client / campaign

    Доступ к партнерскому API Яндекс.Маркета для клиента или магазина запрещен.

    Клиенты агентств должны обратиться к своему агентству по вопросу предоставления доступа к партнерскому API Яндекс.Маркета.

    Client id is invalid

    Указанный идентификатор приложения (параметр oauth_client_id) невалидный.

    Проверьте корректность авторизационных данных. Если они верны, получите новый идентификатор для приложения, повторите запрос с новыми авторизационными данными.

    Scope is invalid

    Указанный авторизационный токен (параметр oauth_token) не обладает необходимым набором прав.

    Получите новый авторизационный токен, указав при получении право использования партнерского API Яндекс.Маркета; повторите запрос с новыми авторизационными данными.

    Token is invalid

    Указанный авторизационный токен (параметр oauth_token) невалидный.

    Проверьте корректность авторизационных данных. Если они верны, получите новый авторизационный токен, повторите запрос с новыми авторизационными данными.

    User account is disabled

    Учетная запись пользователя, для которого выдан указанный авторизационный токен, заблокирована.

    Обратитесь в службу технической поддержки Яндекс.Маркета.

  • Для ошибки 404 Not Found:

    Описание

    Пояснение

    Способ возможного решения

    Feed not found: 'feedId'

    Указанный в запросе прайс-лист не найден.

    Проверьте корректность передаваемого идентификатора прайс-листа.

    Login not found: 'login'

    Указанный в запросе логин не найден.

    Проверьте корректность передаваемого логина.

    Model not found: 'modelId'

    Указанная в запросе модель не найдена.

    Проверьте корректность передаваемого идентификатора модели.

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

    Описание

    Пояснение

    Способ возможного решения

    Request method 'method' not supported

    Запрашиваемый HTTP-метод не поддерживается.

    Проверьте методы, которые поддерживаются ресурсом. Список всех методов приведен в разделе Справочник ресурсов.

  • Для ошибки 415 Unsupported Media Type:

    Описание

    Пояснение

    Способ возможного решения

    Content type 'content-type' not supported

    Запрашиваемый тип контента не поддерживается.

    Передайте один из поддерживаемых типов контента.

    Missing Content-Type

    Не указан тип контента.

    Передайте тип контента.

    Unknown content-type: 'content-type'

    Запрашиваемый тип контента — неизвестен.

    Передайте один из поддерживаемых типов контента.

  • Для ошибки 420 Enhance Your Calm:

    Описание

    Пояснение

    Способ возможного решения

    Hit rate limit of 'N' parallel requests

    Превышено глобальное ограничение на количество одновременных запросов к партнерскому API Яндекс.Маркета.

    Уменьшите количество параллельных запросов к партнерскому API в рамках одного магазина или партнера до N запросов.

    Hit rate limit of 'N' requests per 'period' for resource 'R'

    Превышено ресурсное ограничение на количество N запросов к ресурсу R за период period для одного и того же магазина или партнера.

    Время, до которого действует ограничение, указано в заголовке X-RateLimit-Resource-Until. Использование ресурса станет возможным после наступления указанного времени.

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

    Описание

    Пояснение

    Способ возможного решения

    Service temporarily unavailable. Please, try again later

    Сервер временно недоступен из-за высокой загрузки.

    Попробуйте повторить запрос через некоторое время.

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

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

GET /v2/campaigns/10003/orders.xml HTTP/1.1
Host: api.partner.market.yandex.ru
Accept: */*
Authorization: OAuth oauth_token=,oauth_client_id=b12320932d4e401ab6e1ba43d553d433

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

<response>
  <errors>
    <error code="UNAUTHORIZED" message="OAuth token is not specified"/>
  </errors>
  <error code="401">
    <message>OAuth token is not specified</message>
  </error>
</response>