Получение истории изменения количества неработающих внутренних ссылок сайта

Возвращает историю изменения количества неработающих внутренних ссылок сайта.

Внимание

Убедитесь, что в настройках приложения, которое вы регистрировали на Яндекс OAuth для работы с API Вебмастера, добавлен доступ Получение информации о внешних ссылках на сайт (webmaster:hostinfo).

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

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/links/internal/broken/history
  ? [date_from=<datetime>]
  & [date_to=<datetime>]

user-id

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

host-id

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

date_from

Дата начала интервала. Если не указан, то данные возвращаются за текущий день.

date_to

Дата конца интервала. Если не указан, то данные возвращаются за текущий день.

Формат ответа

Примеры

{
    "indicators": {
        "DISALLOWED_BY_USER": [
            {
                "date": "2019-04-15T00:00:00.000+03:00",
                "value": 116
            }
        ]
    }
}

<Data>
    <indicators>
        <DISALLOWED_BY_USER>
            <date>2019-04-15T00:00:00.000+03:00</date>
            <value>116</value>
        </DISALLOWED_BY_USER>
    </indicators>
</Data>

Имя

Обязательный

Тип

Описание

DISALLOWED_BY_USER

Нет

ApiInternalLinksBrokenIndicator

Причина, по которой ссылка не работает.

Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator)

Индикатор

Описание

SITE_ERROR

Общее количество известных внешних ссылок на сайт.

DISALLOWED_BY_USER

Страница не существует или ее индексирование запрещено.

UNSUPPORTED_BY_ROBOT

Не поддерживаются основным индексирующим роботом Поиска.

Коды ответа

Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

Код

Причина

Описание

200

OK

403

INVALID_USER_ID

ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже {user_id} указан правильный uid владельца OAuth-токена.

{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <[error_code](*error_code)>INVALID_USER_ID</error_code>
    <[available_user_id](*available_user_id)>1</available_user_id>
    <[error_message](*error_message)>Invalid user id. {user_id} should be used.</error_message>
</Data>

404

HOST_NOT_VERIFIED

Не подтверждены права на управление сайтом.

{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}

<Data>
  <[error_code](*error_code)>HOST_NOT_VERIFIED</error_code>  
  <[host_id](*host_id)>http:ya.ru:80</host_id>
  <[error_message](*error_message)>some string</error_message>
</Data>

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

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

Дата начала интервала. Если не указан, то данные возвращаются за текущий день.

Дата конца интервала. Если не указан, то данные возвращаются за текущий день.

Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator)

Индикатор

Описание

SITE_ERROR

Общее количество известных внешних ссылок на сайт.

DISALLOWED_BY_USER

Страница не существует или ее индексирование запрещено.

UNSUPPORTED_BY_ROBOT

Не поддерживаются основным индексирующим роботом Поиска.

Индикаторы внутренних ссылок (ApiInternalLinksBrokenIndicator)

Индикатор

Описание

SITE_ERROR

Общее количество известных внешних ссылок на сайт.

DISALLOWED_BY_USER

Страница не существует или ее индексирование запрещено.

UNSUPPORTED_BY_ROBOT

Не поддерживаются основным индексирующим роботом Поиска.
Предыдущая
Получение информации о неработающих внутренних ссылках сайта
Следующая
Получение информации о внешних ссылках на сайт