Получение информации о подтверждении сайта

Возвращает информацию о текущем состоянии подтверждения сайта в Яндекс Вебмастере.

Формат запроса

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/verification

Формат ответа

Примеры

JSON

XML

{
  "verification_uin": "b01288afe67b1595",
  "verification_state": "NONE",
  "verification_type": "META_TAG",
  "latest_verification_time": "2016-01-01T00:00:00,000+0300",
  "fail_info": {
    "reason": "META_TAG_NOT_FOUND",
    "message": "explicit error message"
  },
  "applicable_verifiers": [
    "META_TAG", ...
  ]
}

<Data>
    <verification_uin>b01288afe67b1595</verification_uin>
    <verification_state>NONE</verification_state>
    <verification_type>META_TAG</verification_type>
    <latest_verification_time>2016-01-01T00:00:00,000+0300</latest_verification_time>
    <fail_info>
        <reason>META_TAG_NOT_FOUND</reason>
        <message>explicit error message</message>
    </fail_info>
    <applicable_verifier>META_TAG</applicable_verifier>
    ...
</Data>

Имя	Обязательный	Тип	Описание
verification_uin	Да	string	Уникальный код подтверждения.
verification_state	Да	string (ApiVerificationState)	Состояние подтверждения прав.
verification_type	Да	string (ApiVerificationType)	Тип подтверждения прав.
latest_verification_time	Да	datetime	Время последней проверки в формате yyyy-MM-ddTHH:mm:ss,sssZ (если verification_state не равно NONE).
fail_info	Да		Описание ошибки, если получен статус VERIFICATION_FAILED.
reason	Да	string (ApiVerificationFailReason)	Причина неудачной проверки.
message	Да	string	Описание ошибки для пользователей.
applicable_verifiers	Да	string (ApiExplicitVerificationType)	Способы подтверждения, применимые для выбранного сайта.

Коды ответа

Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <error_code>INVALID_USER_ID</error_code>
    <available_user_id>1</available_user_id>
    <error_message>Invalid user id. {user_id} should be used.</error_message>
</Data>

{
  "error_code": "HOST_NOT_FOUND",
  "host_id": "http:ya.ru:80",
  "error_message": "explicit error message"
}

<Data>
    <error_code>HOST_NOT_FOUND</error_code>
    <host_id>http:ya.ru:80</host_id>
    <error_message>explicit error message</error_message>
</Data>

Узнайте больше

• Коды ошибок и статусы