Sections in this category

Битые ссылки

  • Обновлено

HTTP-метод

Права доступа

URL

Параметры

Примечание

GET broken_links https://api.admitad.com/broken_links/
  • limit**
  • offset**
  • website ***
  • campaign ****
  • search *****
  • reason ******
  • start_date *******
  • end_date *******

Возвращает список битых ссылок*.

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 — Рекламный материал удален).

  • start_date
  • end_date

 

Пример запроса с использованием утилиты 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"
}
}
]
}

 

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

 

HTTP-метод

Права доступа

URL

Параметры

Примечание

POST manage_broken_links https://api.admitad.com/
broken_links/resolve/
  • link_id**
  • Формат данных запроса application/x-www-form-urlencoded.

  • Возвращает список идентификаторов битых ссылок*.

  • * Возвращает список идентификаторов битых ссылок помеченных как решенные в формате JSON.

  • ** идентификатор битой ссылки, которую надо пометить как решенную

    &link_id=12, где значение — это идентификатор битой ссылки.

 

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

curl -L -H 'Authorization: Bearer access_token' -X POST https://api.admitad.com/broken_links/resolve/ -d 'link_id=19&link_id=20'


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

{
"marked_as_resolved": [
20,
19
]
}

Была ли эта статья полезной?

Пользователи, считающие этот материал полезным: 0 из 0