Отправка одной страницы
Отправляет URL страницы сайта в Яндекс с поддержкой протокола IndexNow.
Формат запроса
GET https://yandex.com/indexnow
? url=<String>
& key=<String>
& [keyLocation=<String>]
url * | Адрес страницы, данные о которой вы хотите передавать. Должен соответствовать стандарту RFC3986. |
key * | Ключ для подтверждения прав на сайт. При отправке запроса поисковая система сверяет это значение с содержимым файла. |
keyLocation | Указание на расположение файла с ключом, если он размещен не в корневой директории сайта. |
url * | Адрес страницы, данные о которой вы хотите передавать. Должен соответствовать стандарту RFC3986. |
key * | Ключ для подтверждения прав на сайт. При отправке запроса поисковая система сверяет это значение с содержимым файла. |
keyLocation | Указание на расположение файла с ключом, если он размещен не в корневой директории сайта. |
* Обязательный параметр
Формат ответа
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 | Параметр keyLocation указан неверно. |
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 | Отсутствует параметр key в запросе. |
422 | No url provided | Отсутствует параметр url в запросе. |
429 | Too Many Requests | Превышено количество запросов для одного IP-адреса. |
Код | Причина | Описание |
---|---|---|
202 | Accepted | Новый ключ ожидает проверки. Если вы уверены, что он корректный, подождите некоторое время и отправьте несколько других адресов. Если код изменился на 200 OK, значит, ключ проверен и адреса переданы. Если код остался 202, то ключ еще не был добавлен в базу после проверки и необходимо еще подождать. |
403 | Invalid key | Ключ не удалось загрузить или он не подходит к указанным в запросе адресам. |
405 | Method not allowed | Поддерживаются методы GET и POST. |
422 | Invalid key location | Параметр keyLocation указан неверно. |
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 | Отсутствует параметр key в запросе. |
422 | No url provided | Отсутствует параметр url в запросе. |
429 | Too Many Requests | Превышено количество запросов для одного IP-адреса. |
Вопросы и ответы
Насколько часто можно передавать запросы?
Ограничения на количество запросов нет, вы можете сами регулировать их частоту — Яндекс использует алгоритмы, которые препятствуют слишком большому потоку запросов.
Можно ли отправлять один и тот же URL-адрес несколько раз в день?
Мы не рекомендуем оправлять слишком часто один и тот же адрес. Если это необходимо, делайте паузу между отправками (10 минут). Если страница часто обновляется, используйте другие способы для сообщения об этом Яндексу.
Можно ли отправлять страницы с HTTP-кодом 404 через API?
Да, вы можете использовать IndexNow, чтобы сообщать о страницах с кодом 404 или 410.
Можно ли передавать страницы с HTTP-кодом 301 или 302 (перенаправление)?
Да, вы можете передавать адреса с информацией о редиректе или других изменениях.