Ответ IndexNow из одного числа — 200, 202, 403, 422 или 429 — говорит, дошло ли уведомление и что чинить, если не дошло. Разберём каждый код, типичные причины и реальные примеры запросов, а затем соберём простой скрипт, который сам отличает «всё хорошо» от «пора разбираться».
Как выглядит запрос и где смотреть ответ
IndexNow принимает два вида запросов. Для одного адреса — GET:
curl -i "https://api.indexnow.org/indexnow?url=https://example.ru/page/&key=ВАШ_КЛЮЧ"
Для нескольких адресов — POST с JSON:
curl -i -X POST "https://api.indexnow.org/indexnow" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"host": "example.ru",
"key": "ВАШ_КЛЮЧ",
"keyLocation": "https://example.ru/ВАШ_КЛЮЧ.txt",
"urlList": ["https://example.ru/page-1/", "https://example.ru/page-2/"]
}'
Флаг -i показывает строку состояния и заголовки. Смотрите первую строку: HTTP/2 200, HTTP/2 403 и так далее. Тело ответа у IndexNow, как правило, пустое либо короткое, поэтому весь смысл заключён в коде.
Обратите внимание: запрос можно отправить на api.indexnow.org или напрямую в конечную точку конкретной поисковой системы, например Яндекса или Bing. Уведомление, принятое одним участником протокола, передаётся остальным, поэтому слать один и тот же список всем сразу не нужно.
Таблица кодов ответа
| Код | Значение | Что делать |
|---|---|---|
| 200 OK | Запрос принят | Ничего. Следите за индексацией другими способами |
| 202 Accepted | Запрос принят, ключ будет проверен позже | Убедитесь, что файл ключа доступен: проверка ещё впереди |
| 400 Bad Request | Неверный формат запроса | Проверьте JSON, кодировку, обязательные поля host, key, urlList |
| 403 Forbidden | Ключ недействителен: файл не найден или значение не совпало | Откройте файл ключа в браузере, сверьте значение, уберите лишние символы |
| 422 Unprocessable Entity | Адреса не принадлежат хосту либо ключ не соответствует схеме | Проверьте протокол, www и поддомены, формат ключа |
| 429 Too Many Requests | Слишком много запросов | Сократите частоту, объединяйте адреса в пачки, уберите дубли |
Если вы видите иной код (500, 502, 503), это сбой на стороне получателя или промежуточного узла. Повторите запрос позже с нарастающей паузой.
200 и 202: «принято» — это не «проиндексировано»
Код 200 означает, что поисковая система приняла уведомление. Это единственная гарантия. Что произойдёт дальше, зависит от поисковой системы: она может обойти страницу быстро, позже или не включать в выдачу, если страница дублирует другую, закрыта от индексации, слишком слабая по содержанию или отдаёт ошибку.
Код 202 — тоже «принято», но ключ ещё не был проверен: поисковая система поставила проверку в очередь. Если файл ключа доступен и значение верно, всё завершится удачно. Если нет, уведомления будут отбрасываться, хотя вы получили 202. Поэтому после первой настройки полезно открыть файл ключа вручную и сравнить его содержимое.
Что делать после 200 и 202:
- проверьте, что страница отдаёт 200, а не редирект или 404;
- убедитесь, что в ней нет
noindex, а в robots.txt нет запрета; - проверьте canonical: он должен указывать на этот же адрес;
- через несколько дней проверьте статус страницы в Яндекс Вебмастере и Bing Webmaster Tools.
400: проблема формата
Ответ 400 означает, что сервер не понял запрос. Самые частые причины:
- Невалидный JSON. Лишняя запятая, неэкранированные кавычки, одинарные кавычки вместо двойных. Проверьте тело запроса любым валидатором JSON.
- Неверный Content-Type. Заголовок должен быть
application/json; charset=utf-8. - Нет обязательных полей. Для POST нужны
host,keyиurlList. - Адрес в параметре URL без кодирования. В GET-запросе адрес со своими параметрами необходимо закодировать (percent-encoding):
https%3A%2F%2Fexample.ru%2Fpage%2F%3Fa%3D1. - Кириллические адреса. Домены на кириллице передавайте в punycode, пути — в закодированном виде.
403: проблема с ключом
Это самая частая ошибка при первой настройке. Поисковая система не смогла подтвердить, что вы владеете сайтом. Проверьте по порядку:
- Файл открывается. Адрес
https://ваш-сайт/КЛЮЧ.txtдолжен давать 200 без редиректа на страницу входа или заглушку. - Значение совпадает. Внутри файла должна быть та же строка, что в параметре
key. Лишний пробел, перевод строки или BOM в начале файла иногда приводят к отказу. - Правильный хост. Файл лежит на том же хосте, что и страницы. Для
www.example.ruиexample.ru— это разные хосты. - Нет защиты, блокирующей роботов. Файрволы, защита от ботов и проверки CDN могут отдавать роботам поисковых систем страницу-проверку вместо файла.
- Кеш. Если вы только что заменили ключ, прокси или CDN могут продолжать отдавать старый файл.
- keyLocation. Если вы указали собственный путь к файлу, убедитесь, что адрес находится на том же хосте и каталоге, что и отправляемые страницы.
Если ключ утерян или скомпрометирован, сгенерируйте новую строку, создайте новый файл и обновите настройки в плагине или сервисе. Старый файл можно удалить.
422: адреса и ключ не сходятся
Ответ 422 говорит, что запрос синтаксически верен, но его содержание не подходит. Основные причины:
- Адрес на другом хосте. В
hostуказанexample.ru, а в списке естьhttps://www.example.ru/...илиhttps://shop.example.ru/.... Один запрос — один хост. - Разные протоколы и порты. Следите, чтобы адреса соответствовали тому варианту, под которым сайт доступен (обычно https).
- Адрес не абсолютный. Нужен полный URL с протоколом, а не путь вида
/page/. - Ключ не соответствует правилам. Допустимая длина — от 8 до 128 символов; разрешены латинские буквы, цифры и дефис. Пробелы и кириллица недопустимы.
- Слишком много адресов. В одном запросе не должно быть больше 10 000 адресов.
Решение обычно сводится к тому, чтобы сгруппировать адреса по хостам и отправлять отдельные запросы для каждого поддомена.
429: слишком часто
Если вы получаете 429, поисковая система ограничивает частоту обращений. Типичные источники проблемы:
- плагин отправляет уведомление при каждом сохранении черновика или автосохранении;
- установлено сразу несколько плагинов, и каждый отправляет одни и те же адреса;
- скрипт после деплоя отправляет весь сайт, а не только изменённые страницы;
- повторные попытки без паузы после сбоя.
Как избежать:
- Отправляйте только новые и существенно изменённые страницы.
- Объединяйте адреса в одну пачку POST-запросом вместо сотни отдельных GET.
- Ведите список уже отправленных адресов и не повторяйте их без причины.
- Применяйте экспоненциальную паузу при повторе: 1, 2, 4, 8 минут.
- Оставьте один источник отправки.
Скрипт для проверки и повторной отправки
Небольшой пример на Node.js, который отправляет пачку адресов, различает типы ошибок и не бьёт в API бесконечно:
const KEY = process.env.INDEXNOW_KEY;
const HOST = 'example.ru';
async function submit(urls, attempt = 1) {
const res = await fetch('https://api.indexnow.org/indexnow', {
method: 'POST',
headers: { 'Content-Type': 'application/json; charset=utf-8' },
body: JSON.stringify({
host: HOST,
key: KEY,
keyLocation: `https://${HOST}/${KEY}.txt`,
urlList: urls,
}),
});
if (res.status === 200 || res.status === 202) return { ok: true, status: res.status };
if (res.status === 429 || res.status >= 500) {
if (attempt >= 4) return { ok: false, status: res.status, retry: false };
await new Promise((r) => setTimeout(r, 60_000 * 2 ** (attempt - 1)));
return submit(urls, attempt + 1);
}
// 400, 403, 422 — повтор не поможет, нужно чинить запрос или ключ
return { ok: false, status: res.status, retry: false };
}
Логика простая: «принято» — успех; 429 и 5xx — повторяем с паузой; 400, 403 и 422 — повторять бессмысленно, нужно исправить причину. Результат стоит записывать в журнал: так вы увидите, когда именно начались проблемы.
Если вы используете сервис, а не собственные запросы
Сервис индексации берёт на себя повторные попытки, очередь и учёт лимитов. В Index-Now.ru история отправок и статусы доступны в личном кабинете, а проверка файла ключа и корректности адресов выполняется до отправки. Это не отменяет необходимости убедиться, что файл ключа действительно доступен роботам и страницы открываются с кодом 200. Сервисная отправка полезна, когда адресов много, сайтов несколько или нужны уведомления о сбоях.
Чек-лист диагностики
- Откройте файл ключа в браузере — код 200, значение совпадает с ключом.
- Проверьте, что ключ состоит из допустимых символов и имеет длину 8–128.
- Убедитесь, что все адреса в запросе относятся к одному хосту, с тем же протоколом.
- Проверьте формат JSON и заголовок Content-Type.
- Если получаете 429, сократите частоту и уберите повторные отправки.
- Если получаете 5xx, повторите позже и не забывайте про паузу между попытками.
- Проверьте сами страницы: код 200, нет noindex, правильный canonical, нет запрета в robots.txt.
- Следите за статусом индексации в панелях вебмастеров, а не только за ответом IndexNow.
Частые вопросы
Почему я получил 200, а страницы нет в поиске?
Код 200 — подтверждение приёма уведомления, а не решение об индексации. Причины отсутствия страницы в выдаче такие же, как и без IndexNow: качество, дубли, технические ошибки, запрет индексации, молодой сайт.
Можно ли отправлять один и тот же адрес несколько раз?
Можно, если страница действительно изменилась. Повторы без изменений бесполезны и ведут к ограничению частоты.
Почему 202 вместо 200?
Поисковая система приняла запрос, но проверка ключа ещё не завершена. Это нормально для первых запросов нового ключа; убедитесь, что файл ключа доступен.
Нужно ли отправлять уведомление при удалении страницы?
Да. Страница должна возвращать 404 или 410, после этого её адрес можно отправить, чтобы поисковая система быстрее перепроверила состояние.
Принимает ли Google IndexNow?
Нет. Протокол поддерживают Bing, Яндекс и ряд других поисковых систем; для Google используйте sitemap.xml и Search Console.
Можно ли указать несколько хостов в одном запросе?
Нет, один запрос относится к одному хосту. Для разных поддоменов отправляйте отдельные запросы.