Список битых ссылок

Параметры

HTTP метод Права доступа URL Параметры Примечание
GET broken_links https://api.admitad.com/broken_links/
  • limit**
  • offset**
  • website ***
  • campaign ****
  • search *****
  • reason ******
  • date_start *******
  • date_end *******
Возвращает список битых ссылок.*
GET broken_links https://api.admitad.com/broken_links/{id}/  

Возвращает информацию о битой ссылке, где id - это идентификатор ссылки.*

  • * Возвращает результат в формате JSON.
  • ** Задаёт пропуск и количество возвращаемых записей. Например limit=5&offset=2.
  • *** Фильтр по площадкам веб-мастера . Например &website=12, где значение - это идентификатор площадки.
  • **** Фильтр по рекламным кампаниям . Например &campaign=6, где значение - это идентификатор кампании.
  • ***** Фильтр по вхождению строки в реферальную или клик ссылку &search=test.io
  • ****** Фильтр по причине ошибки &reason=0, где значение - это идентификатор причины ошибки. (0 - Программа приостановлена, 1 - Вы не сотрудничаете с программой, 2 - Рекламный материал удалён)
  • date_start
  • date_end

Пример использования

Пример запроса с использованием утилиты curl:

curl -L -H 'Authorization: Bearer access_token' -X GET https://api.admitad.com/broken_links/?limit=2

curl -L -H 'Authorization: Bearer access_token' -X https://api.admitad.com/broken_links/3/

Пример ответа API-сервера в формате JSON:

{
    "_meta": {
        "count": 3,
        "limit": 2,
        "offset": 0
    },
    "results": [
        {
            "campaign": {
                "id": 6,
                "name": "AdvCamp 1"
            },
            "click_link": "http://ad.admitad.com/g/395b832b8259505879f5234642e5a7/?ulp=http%3A%2F%2Fsuvcar.ru%2F",
            "clicks": 1,
            "datetime": "2015-10-26T12:34:55",
            "err_reason": 2,
            "id": 20,
            "ref_link": "https://www.google.by/?gfe_rd=cr&ei=GfQtVoaSAqKF8QeN_rv4Ag",
            "website": {
                "id": 22,
                "name": "site1_of_webmaster1"
            }
        },
        {
            "campaign": {
                "id": 6,
                "name": "AdvCamp 1"
            },
            "click_link": "http://ad.admitad.com/g/295b832b8259505879f5234642e5a7/?ulp=http%3A%2F%2Fsuvcar.ru%2F",
            "clicks": 1,
            "datetime": "2015-10-26T12:34:40",
            "err_reason": 2,
            "id": 19,
            "ref_link": "https://www.google.by/?gfe_rd=cr&ei=GfQtVoaSAqKF8QeN_rv4Ag",
            "website": {
                "id": 22,
                "name": "site1_of_webmaster1"
            }
        }
    ]
}

Описание полей ответа API-сервера

Название Описание
id Идентификатор битой ссылки
website Площадка к которой относится нерабочая ссылка
campaign Кампания к которой относится нерабочая ссылка
clicks Количество кликов по нерабочей ссылке
err_reason Причина ошибки (0 - Программа приостановлена, 1 - Вы не сотрудничаете с программой, 2 - Рекламный материал удалён)
click_link Ссылка по которой перешел пользователь
ref_link Ссылка на страницу, откуда пользователь перешел по неработающей ссылке
datetime Дата и время последнего перехода