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

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

  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.
    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: <код подтверждения>
    Электронный адрес из данных WHOIS

    Подтвердите электронный адрес, указанный в WHOIS на странице Адреса электронной почты.

    Этот способ может быть недоступен для ряда доменов верхнего уровня (например, для доменов RU и РФ).

  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.
    user-id Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс.Вебмастера. Чтобы получить его, используйте метод GET /v4/user.
    host-idТип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user-id}/hosts.
    verification_type *Способ подтверждения прав (ApiExplicitVerificationType)
    verification_type *Способ подтверждения прав (ApiExplicitVerificationType)

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