Ключ для верификации пользователя
Для отправки 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, см. описание в таблице.
