Битые ссылки

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

Параметры

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"

            }

        }

    ]

}

Описание полей ответа 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/`	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

    ]

}