Пример подтверждения прав
Для подтверждения прав на управление сайтом, необходимо получить уникальный код и выбрать способ подтверждения:
-
Чтобы получить код подтверждения, отправьте GET-запрос с данными о
user-id
иhost-id
.GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/verification
user-id
Тип:
int64
. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.host-id
Тип:
host id (string)
. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.Ответ будет содержать код подтверждения в параметре verification_uin. Подробно о запросе кода подтверждения.
-
Выберите один из способов подтверждения прав:
Метатег на главной странице
Добавьте в HTML-код главной страницы сайта (в элемент
head
) специальный метатег.<meta name="yandex-verification" content="<код подтверждения>" />
HTML-файл в корневом каталоге
Создайте HTML-файл с уникальным именем вида
yandex_<код подтверждения>.html
и разместить его в корневом каталоге вашего сайта. Файл должен содержать следующее:<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> </head> <body>Verification: <код подтверждения></body> </html>
Запись в DNS
Добавьте в DNS записи сайта запись типа TXT, содержащую указанное уникальное значение.
yandex-verification: <код подтверждения>
-
Запустите процедуру подтверждения прав, используя POST-запрос с данными о выбранном способе подтверждения.
POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/verification ? verification_type=<string>
user-id
Тип:
int64
. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.host-id
Тип:
host id (string)
. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.verification_type
*Способ подтверждения прав (ApiExplicitVerificationType)
* Обязательный параметр
Тип: int64
. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.
Тип: host id (string)
. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.
* Обязательный параметр
Явные способы подтверждения прав (ApiExplicitVerificationType)
Способ подтверждения |
Возможность запроса проверки подтверждения |
Описание |
DNS |
Есть |
Подтверждение прав с помощью DNS-записи. |
HTML_FILE |
Есть |
Размещение HTML-файла в корневом каталоге сайта. |
META_TAG |
Есть |
Добавление метатега в заголовок главной страницы сайта. |
Обязательный
Да
Тип
string
Описание
Уникальный код подтверждения.
Способ подтверждения прав (ApiExplicitVerificationType)