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

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

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

GET https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/links/external/history
 ? (indicator=<string>)
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.
indicator *Индикатор количества внешних ссылок (APIExternalLinksIndicator).
indicator *Индикатор количества внешних ссылок (APIExternalLinksIndicator).

*  Обязательный параметр

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

Примеры

{
  "indicators": {
    "LINKS_TOTAL_COUNT": [
      {
        "date": "2019-01-01T00:00:00,000+0300",
        "value": 1
      }
    ]
  }
}
Имя Обязательный Тип Описание
LINKS_TOTAL_COUNT Да APIExternalLinksIndicator Индикатор количества внешних ссылок.
date Да date Дата обнаружения ссылки.
value Да string Значение индикатора.
Имя Обязательный Тип Описание
LINKS_TOTAL_COUNT Да APIExternalLinksIndicator Индикатор количества внешних ссылок.
date Да date Дата обнаружения ссылки.
value Да string Значение индикатора.

Коды ответа

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

Код Причина Описание
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."
}
404 HOST_NOT_VERIFIED
Не подтверждены права на управление сайтом.
{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}
Код Причина Описание
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."
}
404 HOST_NOT_VERIFIED
Не подтверждены права на управление сайтом.
{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}