Отправка нескольких страниц
Отправляет несколько URL страниц сайта в Яндекс с поддержкой протокола IndexNow.
Формат запроса
POST https://yandex.com/indexnow
Чтобы передавать информацию о нескольких страницах, используйте формат JSON:
POST /indexnow HTTP/1.1
Content-Type: application/json; charset=utf-8
Content-Length: 286
Host: yandex.com
{
"host": "www.example.com",
"key": "EdD8dkmdNLlxREi2LkhJjYOH2kyQbJqM3cBKT5fX",
"keyLocation": "https://www.example.com/myIndexNowKey63638.html",
"urlList": [
"https://www.example.com/url1",
"https://www.example.com/folder/url2",
"https://www.example.com/url3"
]
}
Параметр | Тип | Обязательно | Описание |
---|---|---|---|
host | String | Да | Адрес вашего сайта. |
key | String | Да | Ключ для подтверждения прав на сайт. |
keyLocation | String | Нет | Указание на расположение ключа, если он размещен не в корневой директории сайта. |
urlList | Array | Да | Содержит адреса страниц (String), данные о которых вы хотите передавать. В одном запросе можно передавать до 10 000 адресов. |
Параметр | Тип | Обязательно | Описание |
---|---|---|---|
host | String | Да | Адрес вашего сайта. |
key | String | Да | Ключ для подтверждения прав на сайт. |
keyLocation | String | Нет | Указание на расположение ключа, если он размещен не в корневой директории сайта. |
urlList | Array | Да | Содержит адреса страниц (String), данные о которых вы хотите передавать. В одном запросе можно передавать до 10 000 адресов. |
Формат ответа
HTTP-код 200 OK
content-type: application/json
Другие коды ответа:
Код | Причина | Описание |
---|---|---|
202 | Accepted | Новый ключ ожидает проверки. Если вы уверены, что он корректный, подождите некоторое время и отправьте несколько других адресов. Если код изменился на 200 OK, значит, ключ проверен и адреса переданы. Если код остался 202, то ключ еще не был добавлен в базу после проверки и необходимо еще подождать. |
400 | Invalid params | Переданы некорректные параметры в теле запроса. |
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 host provided | Отсутствует параметр host в запросе. |
422 | No key provided | Отсутствует параметр key в запросе. |
422 | No more than 10000 urls allowed | Параметр urlList содержит больше 10 000 URL-адресов. |
422 | No url provided | Отсутствует параметр url в запросе. |
422 | Url list has to be an array | Отсутствует параметр urlList или он не является массивом. |
422 | Url list cannot be empty | Передан пустой параметр urlList. |
422 | Url has to be an array of string | Параметр urlList должен содержать данные типа String. |
429 | Too Many Requests | Превышено количество запросов для одного IP-адреса. |
Код | Причина | Описание |
---|---|---|
202 | Accepted | Новый ключ ожидает проверки. Если вы уверены, что он корректный, подождите некоторое время и отправьте несколько других адресов. Если код изменился на 200 OK, значит, ключ проверен и адреса переданы. Если код остался 202, то ключ еще не был добавлен в базу после проверки и необходимо еще подождать. |
400 | Invalid params | Переданы некорректные параметры в теле запроса. |
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 host provided | Отсутствует параметр host в запросе. |
422 | No key provided | Отсутствует параметр key в запросе. |
422 | No more than 10000 urls allowed | Параметр urlList содержит больше 10 000 URL-адресов. |
422 | No url provided | Отсутствует параметр url в запросе. |
422 | Url list has to be an array | Отсутствует параметр urlList или он не является массивом. |
422 | Url list cannot be empty | Передан пустой параметр urlList. |
422 | Url has to be an array of string | Параметр urlList должен содержать данные типа String. |
429 | Too Many Requests | Превышено количество запросов для одного IP-адреса. |
Вопросы и ответы
Насколько часто можно передавать запросы?
Ограничения на количество запросов нет, вы можете сами регулировать их частоту — Яндекс использует алгоритмы, которые препятствуют слишком большому потоку запросов.
Можно ли отправлять один и тот же URL-адрес несколько раз в день?
Мы не рекомендуем оправлять слишком часто один и тот же адрес. Если это необходимо, делайте паузу между отправками (10 минут). Если страница часто обновляется, используйте другие способы для сообщения об этом Яндексу.
Можно ли отправлять страницы с HTTP-кодом 404 через API?
Да, вы можете использовать IndexNow, чтобы сообщать о страницах с кодом 404 или 410.
Можно ли передавать страницы с HTTP-кодом 301 или 302 (перенаправление)?
Да, вы можете передавать адреса с информацией о редиректе или других изменениях.