Яндекс 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 слов. |
| 200 | На вашем счету закончились деньги. Для дальнейшей работы пополните баланс в системе XMLstock.com Ранее использовался код: -32 |
| -34 | Не корректный ID пользователя или ключ |
| Асинхронные запросы | |
| 201 | Повторный запрос результатов (из кеша) можно совершать не чаще одного раза в 30 секунд |
| 202 | Запрос еще не обработан, сделайте перезапрос через несколько секунд |
| 203 | Запроса c заданным ID не существует либо вышло время его хранения |
| 210 | Запрос поставлен в очередь и будет обработан. Для получения данных отправьте его повторно через несколько секунд |
Обращаем ваше внимание, что ответы с кодами 1,15,18,19,37,210,10001,10002 тарифицируются в соответствии с тарифным планом, за ответы с иными кодами ошибок тарификация не ведется.
Ошибки сервера
Также может возникнуть ситуация, когда возникает ошибка сервера. При этом он возвращает HTTP-Code, отличный от 200-го. Это означает, что запрос не обработан и что-то пошло не так. Деньги за такие запросы не списываются.
| HTTP-код ошибки сервера | Описание ошибки |
|---|---|
| 500-502 | Внутренняя ошибка сервера. Необходимо сделать перезапрос. |
| 503 | Превышено максимально допустимое количество запросов в секунду/минуту. |
