Получить список регулярных кампаний
Описание
Получить список регулярных кампаний.
URL-адрес
Метод: POST
https://example.com/api/v1.1/campaigns/regulars/list/
Параметры запроса
Параметр | Тип | Пример | Обязательный | Описание |
---|---|---|---|---|
token | string | "abcdefghijklmnqrstuvwxyz" | Да | API токен |
from_id | int | 11768 | Нет | Идентификатор первой кампании в списке. По умолчанию – 1. |
limit | int | 10 | Нет | Лимит на количество возвращаемых данных. По умолчанию – 1000. |
format | string | "json" | Нет | Формат возвращаемых данных. По умолчанию – "json". |
is_active | bool | true | Нет | Только активные кампании если true |
ui_tags | []String | [ "tag1", "tag2" ] | Нет | Список тегов для поиска. По умолчанию – []. |
groups | []String | [ "group1", "group2" ] | Нет | Список групп для поиска. По умолчанию – []. |
groups_id | []int | [ 0, 1 ] | Нет | Список Id групп для поиска. По умолчанию – []. |
Пример запроса
- JSON
- XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"limit": 2
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<limit>2</limit>
</xml>
Пример ответа
- JSON
- XML
{
"data": [
{
"id": 15,
"name": "Regular campaign 1",
"type": "regular",
"is_active": true,
"for_confirm": false,
"ui_tags": [
"B2C"
],
"groups": [
{
"id": 1,
"name": "subaccount"
}
]
},
{
"id": 78,
"name": "Regular campaign 2",
"type": "regular",
"is_active": false,
"for_confirm": false,
"ui_tags": [
"B2C"
],
"groups": [
{
"id": 1,
"name": "subaccount"
}
]
}
],
"error": 0,
"error_text": "Successful operation",
"total_count": 3
}
<xml>
<data>
<for_confirm>false</for_confirm>
<groups>
<id>1</id>
<name>subaccount</name>
</groups>
<id>15</id>
<is_active>true</is_active>
<name>Regular campaign 1</name>
<type>regular</type>
<ui_tags>B2C</ui_tags>
</data>
<data>
<for_confirm>false</for_confirm>
<groups>
<id>1</id>
<name>subaccount</name>
</groups>
<id>78</id>
<is_active>false</is_active>
<name>Regular campaign 2</name>
<type>regular</type>
<ui_tags>B2C</ui_tags>
</data>
<error>0</error>
<error_text>Successful operation</error_text>
<total_count>3</total_count>
</xml>
Возвращаемые параметры
Параметр | Тип | Описание |
---|---|---|
error | int | Код ошибки |
error_text | string | Текст ошибки |
id | int | Идентификатор кампании |
name | string | Название кампании |
type | string | Тип кампании |
is_active | bool | Статус кампании |
for_confirm | bool | Имеет ли кампания сообщения со ссылкой подтверждения |
total_count | int | Общее количество кампаний |
ui_tags | []String | Список тегов |
groups | []String | Список групп |