Запуск процедуры подтверждения прав

Запускает процедуру подтверждения прав на управление сайтом.

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

Отправьте POST-запрос на адрес ресурса подтверждения сайта пользователя. Обязательно укажите способ подтверждения GET-параметром. В теле запроса можно передавать произвольные данные или не передавать ничего.

POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/verification
 ? verification_type=<string>

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

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

Пример

JSON

XML

HTTP/1.1 200 OK
{
  "verification_uin": "b01288afe67b1595",
  "verification_state": "IN_PROGRESS",
  "verification_type": "HTML_FILE",
  "applicable_verifiers": [
    "HTML_FILE"
  ]
}

<Data>
    <verification_uin>b01288afe67b1595</verification_uin>
    <verification_state>IN_PROGRESS</verification_state>
    <verification_type>HTML_FILE</verification_type>
    <applicable_verifier>HTML_FILE</applicable_verifier>
</Data>

Имя	Обязательный	Тип	Описание
verification_uin	Да	string	Код подтверждения.
verification_state	Да	string (ApiVerificationState)	Состояние подтверждения прав.
verification_type	Да	string (ApiVerificationType)	Тип подтверждения прав.
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>

{
  "error_code": "VERIFICATION_ALREADY_IN_PROGRESS",
  "verification_type": "META_TAG",
  "error_message": "some string"
}

<Data>
  <error_code>VERIFICATION_ALREADY_IN_PROGRESS</error_code>  
  <verification_type>META_TAG</verification_type> 
  <error_message>some string</error_message>
</Data>

{
  "error_code": "NO_VERIFICATION_RECORD",
  "error_message": "some string"
}

<Data>
  <error_code>NO_VERIFICATION_RECORD</error_code>  
  <error_message>some string</error_message>
</Data>

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

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