Пример подтверждения прав

Для подтверждения прав на управление сайтом, необходимо получить уникальный код и выбрать способ подтверждения:

  1. Чтобы получить код подтверждения, отправьте 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. Подробно о запросе кода подтверждения.

  2. Выберите один из способов подтверждения прав:

    Метатег на главной странице

    Добавьте в 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: <код подтверждения>
    
  3. Запустите процедуру подтверждения прав, используя 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)

    * Обязательный параметр