Получение информации о неработающих внутренних ссылках сайта
Возвращает примеры неработающих внутренних ссылок сайта. Список примеров ссылок формируется на основе данных робота Яндекса. Ссылка может считаться неработающей, если допущена ошибка в адресе (URL) страницы, URL страницы изменился или страница не существует.
Внимание
Убедитесь, что в настройках приложения, которое вы регистрировали на Яндекс OAuth для работы с API Вебмастера, добавлен доступ Получение информации о внешних ссылках на сайт (webmaster:hostinfo).
Формат запроса
GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/links/internal/broken/samples
? [offset=<int32>]
& [limit=<int32>]
& [indicator=<string>]
|
Тип: |
|
Тип: |
|
Смещение в списке. Минимальное значение — 0. Значение по умолчанию: 0. |
|
Количество записей (1-100). Значение по умолчанию: 10. |
|
Индикатор неработающей ссылки — причина, по которой ссылка не работает (ApiInternalLinksBrokenIndicator). Можно указать несколько индикаторов. Например, Если индикатор не указан, отчет будет содержать все типы ссылок. |
Индикатор |
Описание |
|
Общее количество известных внешних ссылок на сайт. |
|
Страница не существует или ее индексирование запрещено. |
|
Не поддерживаются основным индексирующим роботом Поиска. |
Формат ответа
Примеры
JSONXML
{ "count": 1, "links": [ { "source_url": "http://example.com/page1/", "destination_url": "https://example.com/page2/", "discovery_date": "2019-01-01", "source_last_access_date": "2019-01-01", }, ... ] }
<Data> <count>1</count> <link> <source_url>https://example.com/page1/</source_url> <destination_url>https://example.com/page2/</destination_url> <discovery_date>2019-01-01</discovery_date> <source_last_access_date>2019-01-01</source_last_access_date> </link> ... </Data>
Имя |
Обязательный |
Тип |
Описание |
|
Да |
|
Количество доступных примеров ссылок. |
|
Да |
|
URL страницы, содержащей ссылку на сайт. |
|
Да |
|
URL страницы назначения (на которую ведет ссылка). |
|
Да |
|
Дата обнаружения ссылки. |
|
Да |
|
Дата последнего посещения роботом страницы назначения ссылки. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код |
Причина |
Описание |
200 |
OK |
|
403 |
ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже JSON
XML
|
|
404 |
Не подтверждены права на управление сайтом. JSON
XML
|
Узнайте больше
Тип: int64
. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.
Тип: host id (string)
. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.
Обязательный параметр
Смещение в списке. Минимальное значение — 0. Значение по умолчанию: 0.
Количество записей (1-100). Значение по умолчанию: 10.
Описание
Код ошибки.
Описание
Сообщение об ошибке.
Описание
Значение.
Описание
Поле.
Описание
ID запрошенного сайта.
Описание
ID сайта.
Описание
Признак подтверждения сайта.
Описание
ID файла Sitemap
.
Описание
Список поддерживаемых типов контента.
Описание
Лимит на количество добавленных сайтов.
Описание
Лимит количества фидов.
Описание
Лимит количества добавленных фидов.
Описание
ID пользователя, от имени которого разрешен доступ.
Описание
Дата и время, до которого адрес доступен для создания задачи.
Описание
Список поддерживаемых типов контента.
Описание
Список поддерживаемых типов кодировки.
Описание
Максимальная длина.
Описание
Минимальная длина.
Описание
Доступное количество запросов в сутки.
Индикатор неработающей ссылки — причина, по которой ссылка не работает (ApiInternalLinksBrokenIndicator). Можно указать несколько индикаторов. Например, indicator=SITE_ERROR&indicator=DISALLOWED_BY_USER
.
Если индикатор не указан, отчет будет содержать все типы ссылок.
Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator)
Индикатор |
Описание |
|
Общее количество известных внешних ссылок на сайт. |
|
Страница не существует или ее индексирование запрещено. |
|
Не поддерживаются основным индексирующим роботом Поиска. |
Обязательный
Да
Тип
int64
Описание
Количество доступных примеров ссылок.
Обязательный
Да
Тип
string
Описание
URL страницы, содержащей ссылку на сайт.
Обязательный
Да
Тип
url
Описание
URL страницы назначения (на которую ведет ссылка).
Обязательный
Да
Тип
date
Описание
Дата обнаружения ссылки.
Обязательный
Да
Тип
date
Описание
Дата последнего посещения роботом страницы назначения ссылки.