# Битые ссылки
# Список битых ссылок  <span id="list-of-broken-links" />

## Параметры <span id="list-of-broken-links-parameters" />

| HTTP-метод | Права доступа                                                                             | URL                                         | Параметры                    | Примечание                                                                 |
| ---------- | ----------------------------------------------------------------------------------------- | ------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------- |
| GET        | [broken\_links](/article/ru/308#broken-links) | https://api.admitad.com/broken\_links/      | *limit\*\**                  | Возвращает список битых ссылок\*                                           |
|            |                                                                                           |                                             | *offset\*\**                 |                                                                            |
|            |                                                                                           |                                             | *website \*\*\**             |                                                                            |
|            |                                                                                           |                                             | *campaign \*\*\*\**          |                                                                            |
|            |                                                                                           |                                             | *search \*\*\*\*\**          |                                                                            |
|            |                                                                                           |                                             | *reason \*\*\*\*\*\**        |                                                                            |
|            |                                                                                           |                                             | *start\_date \*\*\*\*\*\*\** |                                                                            |
|            |                                                                                           |                                             | *end\_date \*\*\*\*\*\*\**   |                                                                            |
| GET        | [broken\_links](/article/ru/308#broken-links) | https://api.admitad.com/broken\_links/{id}/ |                              | Возвращает информацию о битой ссылке., где id — это идентификатор ссылки\* |

*\* Возвращает результат в формате JSON.*

*\*\* Задаёт пропуск и количество возвращаемых записей. Например,* [*limit\=5\&offset\=2*](/article/ru/310)

*\*\*\* Фильтр по площадкам веб-мастера. Например, \&website\=12, где значение — это идентификатор площадки.*

*\*\*\*\* Фильтр по партнерским программам. Например, \&campaign\=6, где значение — это идентификатор программы.*

*\*\*\*\*\* Фильтр по вхождению строки в реферальную или клик-ссылку \&search\=test.io*

*\*\*\*\*\*\* Фильтр по причине ошибки \&reason\=0, где значение — это идентификатор причины ошибки (0 — Программа приостановлена, 1 — Вы не сотрудничаете с программой, 2 — Рекламный материал удален).*

*   *start\_date*
*   *end\_date*

## Пример использования <span id="list-of-broken-links-example-of-use" />

Пример запроса с использованием утилиты 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-сервера <span id="list-of-broken-links-description-of-api-server-response-fields" />

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

# Решение битых ссылок <span id="fixing-broken-links" />

## Параметры <span id="fixing-broken-links-parameters" />

| HTTP-метод | Права доступа                                                                                            | URL                                            | Параметры      | Примечание                                                                                                            |
| ---------- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------- |
| POST       | [manage\_broken\_links](/article/ru/308#manage-broken-links) | https://api.admitad.com/broken\_links/resolve/ | *link\_id\*\** | Формат данных запроса [application/x-www-form-urlencoded](http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.1) |
|            |                                                                                                          |                                                |                | Возвращает список идентификаторов битых ссылок \*                                                                     |

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

*\*\* идентификатор битой ссылки, которую надо пометить как решенную*
:   *\&link\_id\=12, где значение — это идентификатор битой ссылки.*

## Пример использования <span id="fixing-broken-links-example-of-use" />

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