Отправление страницы сайта на переобход
Отправляет URL на переобход.
Формат запроса
В теле запроса передайте URL страницы, которую нужно переобойти.
POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/recrawl/queue
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. |
Пример
Параметр | Описание |
---|---|
url | URL страницы, отправляемой на переобход. |
Параметр | Описание |
---|---|
url | URL страницы, отправляемой на переобход. |
Формат ответа
Примеры
{
"task_id": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a",
"quota_remainder": 1
}
<Data>
<task_id>c7fe80c0-36e3-11e6-8b2d-df96aa592c0a</task_id>
<quota_remainder>1</quota_remainder>
</Data>
Имя | Обязательный | Тип | Описание |
---|---|---|---|
task_id | Да | UUID | ID задачи на переобход. |
quota_remainder | Да | int32 | Остаток суточной квоты. |
Имя | Обязательный | Тип | Описание |
---|---|---|---|
task_id | Да | UUID | ID задачи на переобход. |
quota_remainder | Да | int32 | Остаток суточной квоты. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
202 | ACCEPTED | |
400 | INVALID_URL | Передан неправильный URL. |
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
409 | URL_ALREADY_ADDED | URL уже добавлен в переобход. |
429 | QUOTA_EXCEEDED | Суточная квота запросов исчерпана. |
Код | Причина | Описание |
---|---|---|
202 | ACCEPTED | |
400 | INVALID_URL | Передан неправильный URL. |
403 | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
409 | URL_ALREADY_ADDED | URL уже добавлен в переобход. |
429 | QUOTA_EXCEEDED | Суточная квота запросов исчерпана. |