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

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

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

Отправьте 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 )	Способы подтверждения, применимые для выбранного сайта.

Статус подтверждения прав на управление сайтом (ApiVerificationState)

Способы подтверждения прав (ApiVerificationType)

Явные способы подтверждения прав (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>

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

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