API Вебмастера
API даёт OAuth-приложению доступ только к сайтам пользователя, который явно подтвердил авторизацию. Чужие сайты и данные аккаунта не доступны.
Права доступа
| Scope | Доступ |
|---|---|
webmaster.read | Список сайтов и показатели индексации. |
webmaster.write | Запрос переобхода подтверждённого сайта; включает чтение. |
Добавьте нужный scope к параметру scope на этапе OAuth: scope=profile webmaster.read.
Список сайтов
GET https://izek.ru/api/webmaster/sites
Authorization: Bearer ACCESS_TOKENТребуется webmaster.read или webmaster.write. Возвращаются только ваши сайты: host, URL, статус подтверждения, число известных и проиндексированных страниц, ошибки, очередь и дата последнего обхода.
Один сайт
GET https://izek.ru/api/webmaster/sites/SITE_ID
Authorization: Bearer ACCESS_TOKENSITE_ID — идентификатор из списка. Не подтверждённый сайт возвращается с состоянием pending или failed, но без внутренних данных диагностики.
Переобход
POST https://izek.ru/api/webmaster/sites/SITE_ID/reindex
Authorization: Bearer ACCESS_TOKENТребуется webmaster.write. Доступно только владельцу подтверждённого сайта и учитывает тот же лимит переобхода, что и кабинет Вебмастера.
Формат ошибок
{"error":"insufficient_scope"}Возможные статусы: 401 — отсутствует или истёк токен; 403 — не хватает scope; 404 — сайт не принадлежит пользователю; 405 — неверный HTTP-метод; 429 — превышен лимит запросов.