Перейти к основному содержимому

Получить список кампаний

Описание

Получить список кампаний.

URL-адрес

Метод: POST

https://example.com/api/v1.1/campaigns/list

Параметры запроса

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
formatstring"json"НетФормат возвращаемых данных
по умолчанию – "json"
from_idint1НетИдентификатор первой кампании в ответе
по умолчанию – 1
limitint2НетЛимит на количество возвращаемых данных
по умолчанию – 1000
typestring"trigger"НетТип кампании
is_activebooltrueНетСтатус кампании
ui_tags[]String[ "tag1", "tag2" ]НетСписок тегов для поиска
по умолчанию – []
groups[]String[ "group1", "group2" ]НетСписок групп для поиска
по умолчанию – []
groups_id[]int[ 0, 1 ]НетСписок Id групп для поиска
по умолчанию – []

Пример запроса

{
"limit": 2,
"token": "abcdefghijklmnqrstuvwxyz"
}

Пример ответа

{
"data": [
{
"id": 1,
"name": "New campaign1",
"type": "regular",
"is_active": true,
"for_confirm": false,
"ui_tags": [
"tag1",
"tag2"
],
"Groups": [
{
"Id": 0,
"Name": "main"
}
]
},
{
"id": 2,
"name": "New campaign2",
"type": "trigger",
"is_active": true,
"for_confirm": false,
"ui_tags": [
"tag3",
"tag4"
],
"Groups": [
{
"Id": 1,
"Name": "subaccount"
}
]
}
],
"error": 0,
"error_text": "Successful operation",
"next_from_id": 4,
"total_count": 14
}

Возвращаемые параметры

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
next_from_idintУказатель необходимо передать в следующем запросе для получения еще одной порции данных, до тех пор пока вывод результата не будет содержать 0 строчек истории
idintИдентификатор кампании
is_activeboolСтатус кампании
namestringНазвание кампании
typestringТип кампании
total_countintОбщее количество кампаний
for_confirmboolИмеет ли кампания сообщения со ссылкой подтверждения
ui_tags[]StringСписок тегов
groups[]StringСписок групп