Informações sobre a CP

campaign/info

Parâmetros:

• token - autorização (string)
• ID - identificador do CP (int)
• category_id - identificador de categoria (int)

É necessário especificar o identificador do CP (id) ou o identificador da categoria (category_id). Se você não passar nenhum desses parâmetros, toda a lista dos CPs será exibida.

Exemplo de chamada de método:

<?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);
    }

// Resultado:

{
    "id": "999999",
    "type": "paid_se",
    "type_name": "visitas do buscador",
    "date_begin": "14.06.2019 13:56",
    "site": "mysite.com (https://google.ru: frase-chave)",
    "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);
    }

// Resultado:

{
    "sites": [
        {
            "id": "999999",
            "type": "paid_se",
            "type_name": "visitas do buscador",
            "date_begin": "14.06.2019 11:27",
            "site": "mysite.com (https://google.ru: frase-chave 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": "visitas do buscador",
            "date_begin": "14.06.2019 13:56",
            "site": "mysite.com (https://google.ru: frase-chave 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
}

Valores possíveis do campo "Status":

• rejected - bloqueado pelo moderador (então a resposta contém também o campo com a causa 'reject_reason').
• moderating - espere moderação.
• stopped - campanha parou.
• active - campanha ativa.
• inactive - campanha inativa (não tem apresentações na conta).

Possíveis códigos de erro

Em geral
1 - não há parâmetros de consulta
7 - acesso proibido
16 - erro desconhecido
37 - temporariamente indisponível, tente mais tarde
38 - nenhuma entidade que corresponda aos parâmetros do pedido
41 - o limite diário de pedidos de API foi atingido mais detalhes