Starting the rights verification process

Starts the procedure for verifying site management rights.

Request format

Send a POST request to the rights verification resource. You must specify the verification method in the GET parameter. The request body can pass any data, or none at all.

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

* Required

Response format

Example

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>

Name	Required	Type	Description
verification_uin	Yes	string	Confirmation code.
verification_state	Yes	string (ApiVerificationState)	The rights verification state.
verification_type	Yes	string (ApiVerificationType)	The type of rights verification.
applicable_verifiers	Yes	string (ApiExplicitVerificationType)	The verification methods applied for the given site.

The status of verifying the right to manage the site (ApiVerificationState)

Rights verification methods (ApiVerificationType)

Explicit methods of rights verification (ApiExplicitVerificationType)

Response codes

To view the response structure in detail, click the reason.

{   
    "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>

Related information

• Error codes and statuses