#318: Битые ссылки

Отредактирована: 11 дней назад

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

Параметры

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  
    ]  
}