Ключ для верификации пользователя
Для отправки URL-адресов необходимо подтвердить, что именно вы являетесь владельцем сайта, для которого передаются данные. Для подтверждения используется специальный ключ — его нужно сформировать и разместить файл с ним на вашем сайте. При каждом запросе к API Яндекс проверяет ключ. Содержимое файла и его расположение должно быть известно только вам и поисковой системе.
Ескерту
Если у вашего сайта есть поддомены, для каждого поддомена используйте отдельный ключ.
Ключ можно сформировать вручную. Также некоторые CMS могут поддерживать IndexNow.
Требования к ключу
-
Поддерживается только кодировка UTF-8.
-
Минимальное количество символов в ключе — 8, максимальное — 128.
-
Ключ может содержать символы
a-z
,A-Z
,0-9
,-
. -
Используйте TXT-файл или другой формат с текстовыми данными. Файл не должен содержать HTML-разметку. Пример:
Как разместить файл с ключом
Вы можете разместить файл:
В этом случае имя файла должно строго соответствовать значению ключа. Например, файл https://www.example.org/EdD8dkmdNLlxREi2LkhJjYOH2kyQbJqM3cBKT5fX.txt
, который содержит ключ EdD8dkmdNLlxREi2LkhJjYOH2kyQbJqM3cBKT5fX
.
В этом случае при каждом запросе к API нужно сообщать о расположении файла с помощью переменной keyLocation. При этом в запросе вместе с ключом могут быть отправлены только те страницы, которые расположены в этом же каталоге.
Например, ключ http://example.com/catalog/key12457EDd.txt
будет действителен для адресов страниц, которые расположены в http://example.com/catalog/
и недействителен для страниц, размещенных в http://example.com/help/
.
Вопросы и ответы
Как проверить, что ключ правильный
Отправьте адреса и проверьте код ответа. Код 202 Accepted означает, что новый ключ ожидает проверки. Убедитесь, что ключ корректный, подождите некоторое время и отправьте еще несколько адресов.
Смена кода на 200 OK означает, что ключ правильный и адреса переданы. Если код остается 202 Accepted, то подождите еще немного и отправьте еще несколько адресов, пока код не станет 200 OK.
Если код сменился на 4XX, см. описание в таблице.
Можно ли использовать несколько ключей для верификации?
Да, если вы используете несколько CMS — для каждой отдельный ключ. Разместите разные файлы ключей в корневой директории сайта.
Можно использовать один ключ для нескольких сайтов?
Да, вы можете повторно использовать один и тот же ключ на двух и более доменах.
Когда нужно изменить ключ?
Ключ менять необязательно. Вы можете изменить ключ, если он стал известен третьим лицам.