Информация о РК

campaign/info

Параметры:

• token - авторизация (string)
• id - идентификатор РК (int)
• category_id - идентификатор категории (int)

Необходимо указать идентификатор РК (id) ИЛИ идентификатор категории (category_id). Если не передать ни идного из этих параметров, будет выведен весь список РК.

Пример вызова метода:

<?php
    $post = array(
        'token' => $token,
        'id' => 999999
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/info');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
        $out = curl_exec($curl);
        echo $out;
        curl_close($curl);
    }

// Результат:

{
    "id": "999999",
    "type": "paid_se",
    "type_name": "посещения из поисковика",
    "date_begin": "14.06.2019 13:56",
    "site": "mysite.com (https://google.ru: ключевая фраза)",
    "one_visit_cost": "0.786",
    "one_visit_currency": "₽",
    "balance_actions": "2996",
    "actions_hour": "0",
    "actions_hour_limit": "1",
    "actions_today": "1",
    "actions_today_limit": "0",
    "comments": "",
    "status": "active",
    "category_id": "9999",
    "category_name": "mysite.com",
    "error_code": 0
}

====================================================================================

<?php
    $post = array(
        'token' => $token,
        'category_id' => 9999
    );
    if ($curl = curl_init()) {
        curl_setopt($curl, CURLOPT_URL, 'https://www.ipweb.ru/api/v2/campaign/info');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
        curl_setopt($curl, CURLOPT_POST, true);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
        $out = curl_exec($curl);
        echo $out;
        curl_close($curl);
    }

// Результат:

{
    "sites": [
        {
            "id": "999999",
            "type": "paid_se",
            "type_name": "посещения из поисковика",
            "date_begin": "14.06.2019 11:27",
            "site": "mysite.com (https://google.ru: ключевая фраза 1)",
            "one_visit_cost": "0.786",
            "one_visit_currency": "₽",
            "balance_actions": "0",
            "actions_hour": "0",
            "actions_hour_limit": "1",
            "actions_today": "0",
            "actions_today_limit": "0",
            "comments": "тест",
            "status": "stopped",
            "category_id": "9999",
            "category_name": "mysite.com"
        },
        {
            "id": "999998",
            "type": "paid_se",
            "type_name": "посещения из поисковика",
            "date_begin": "14.06.2019 13:56",
            "site": "mysite.com (https://google.ru: ключевая фраза 2)",
            "one_visit_cost": "0.786",
            "one_visit_currency": "₽",
            "balance_actions": "992",
            "actions_hour": "0",
            "actions_hour_limit": "1",
            "actions_today": "0",
            "actions_today_limit": "1",
            "comments": "",
            "status": "active",
            "category_id": "9999",
            "category_name": "mysite.com"
        }
    ],
    "error_code": 0
}

Возможные значения поля «Status»:

• rejected - заблокирована модератором (тогда ответ содержит и поле с причиной 'reject_reason').
• moderating - ожидает модерацию.
• stopped - кампания остановлена.
• active - кампания активна.
• inactive - кампания неактивна(у нее нет показов на счету).

Возможные коды ошибок

Общие
1 - параметры запроса отсутствуют
7 - доступ запрещен
16 - неизвестная ошибка
37 - временно недоступно, попробуйте позже
38 - отсутствуют сущности соответствующие параметрам запроса
41 - достигнут дневной лимит запросов API подробнее