Яндекс XML. Руководство разработчика
Яндекс XML - Коды ошибок
При некорректной обработке поисковых запросов ответ будет содержать тег error
Пример ответа с ошибкой:
Коды возможных ошибок
В таблице ниже приведены коды и описания ошибок, которые могут возвращаться в ответе.
При этом HTTP-Code сервера = 200
| Код ошибки | Описание ошибки |
|---|---|
| 1 | Текст запроса (query) содержит синтаксическую ошибку. Например, переданы два идущих подряд слеша (//). |
| 2 | Задан пустой поисковый запрос (в элементе query передано пустое значение). |
| 3-9 | Не верно указано значение для параметра groupby, domain, delayed, device, page, lr, tbm. |
| 15 | Для заданного поискового запроса отсутствуют результаты поиска. |
| 18 | Передаваемый XML-файл не может быть валидирован или заданы некорректные параметры запроса. Возможные причины:
|
| 19 | В поисковом запросе переданы несовместимые параметры/значения. |
| 20, 300 | Неизвестная ошбика. Причина ошибки не может быть установлена. При повторном получении этой ошибки обратитесь в техническую поддержку. |
| 32 | Превышено ограничение на количество допустимых суточных запросов |
| 37 | Ошибка в параметрах запроса. Возможно, не введены обязательные или определены взаимоисключающие параметры. |
| 55 | В данный момент сервис сильно перегружен. Попробуйте повторить запрос еще раз. Данная ошибка может возникать из-за превышения RPS (максимально допустимого количества запросов в секунду с нашей стороны к сервисам Яндекс) |
| 101 | Сервис сбора данных Yandex XML временно отключен. Ведутся технические работы, попробуйте позже. |
| 10001, 10002 | Задан слишком длинный поисковый запрос. Длина запроса не должна превышать 400 символов/40 слов. |
| -32 | На вашем счету закончились деньги. Для дальнейшей работы пополните баланс в системе XMLstock.com |
| -34 | Не корректный ID пользователя или ключ |
| Асинхронные запросы | |
| 201 | Повторный запрос результатов можно совершать не чаще одного раза в минуту |
| 202 | Запрос еще не обработан, попробуйте позже |
| 203 | Запрос c заданным ID не был найден |
Обращаем ваше внимание, что ответы с кодами 1,15,18,19,37,10001,10002 тарифицируются в соответствии с тарифным планом, за ответы с иными кодами ошибок тарификация не ведется.
Ошибки сервера
Также может возникнуть ситуация, когда возникает ошибка сервера. При этом он возвращает HTTP-Code, отличный от 200-го. Это означает, что запрос не обработан и что-то пошло не так. Деньги за такие запросы не списываются.
| HTTP-код ошибки сервера | Описание ошибки |
|---|---|
| 500-502 | Внутренняя ошибка сервера. Необходимо сделать перезапрос. |
| 503 | Превышено максимально допустимое количество запросов в секунду/минуту. |
