Отправка одной страницы
Отправляет URL страницы сайта в Яндекс с поддержкой протокола IndexNow.
Формат запроса
GET https://yandex.com/indexnow
? url=<String>
& key=<String>
& [keyLocation=<String>]
|
Адрес страницы, данные о которой вы хотите передавать. Должен соответствовать стандарту RFC3986. |
|
Ключ для подтверждения прав на сайт. При отправке запроса поисковая система сверяет это значение с содержимым файла. |
|
Указание на расположение файла с ключом, если он размещен не в корневой директории сайта. |
* Обязательный параметр
Формат ответа
HTTP-код 200 OK
content-type: application/json
Другие коды ответа:
Код |
Причина |
Описание |
202 |
Accepted |
Новый ключ ожидает проверки. Если вы уверены, что он корректный, подождите некоторое время и отправьте несколько других адресов. Если код изменился на 200 OK, значит, ключ проверен и адреса переданы. Если код остался 202, то ключ еще не был добавлен в базу после проверки и необходимо еще подождать. |
403 |
Invalid key |
Ключ не удалось загрузить или он не подходит к указанным в запросе адресам. |
405 |
Method not allowed |
Поддерживаются методы GET и POST. |
422 |
Invalid key location |
Параметр |
422 |
Invalid url |
В запросе указан неверный URL-адрес или переданный ключ не подходит для его обработки. |
422 |
Key must be at least 8 characters |
Ключ включает в себя меньше 8 символов. |
422 |
Key must be no longer than 128 characters |
Ключ включает в себя больше 128 символов. |
422 |
Key must consist of a-Z0-9 or '-' |
Ключ содержит неподходящие символы. |
422 |
No key provided |
Отсутствует параметр |
422 |
No url provided |
Отсутствует параметр |
429 |
Too Many Requests |
Превышено количество запросов для одного IP-адреса. |
Вопросы и ответы
Насколько часто можно передавать запросы?
Ограничения на количество запросов нет, вы можете сами регулировать их частоту — Яндекс использует алгоритмы, которые препятствуют слишком большому потоку запросов.
Можно ли отправлять один и тот же URL-адрес несколько раз в день?
Мы не рекомендуем оправлять слишком часто один и тот же адрес. Если это необходимо, делайте паузу между отправками (10 минут). Если страница часто обновляется, используйте другие способы для сообщения об этом Яндексу.
Можно ли отправлять страницы с HTTP-кодом 404 через API?
Да, вы можете использовать IndexNow, чтобы сообщать о страницах с кодом 404 или 410.
Можно ли передавать страницы с HTTP-кодом 301 или 302 (перенаправление)?
Да, вы можете передавать адреса с информацией о редиректе или других изменениях.