Список битых ссылок
Параметры
HTTP-метод |
Права доступа |
URL |
Параметры |
Примечание |
---|---|---|---|---|
GET | broken_links | https://api.admitad.com/broken_links/ |
|
Возвращает список битых ссылок*. |
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"
}
}
]
}
Описание полей ответа API-сервера
Название | Описание |
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/ |
|
|
-
* Возвращает список идентификаторов битых ссылок помеченных как решенные в формате 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
]
}