Получить информацию о регулярной рассылке

Описание

Получить информацию о регулярной рассылке.

URL-адрес

Метод: POST

https://example.com/api/v1.1/campaigns/regulars/get

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

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API токен
id	int	11768	Да	Идентификатор рассылки
format	string	"json"	Нет	Формат возвращаемых данных по умолчанию – "json"

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

JSON

{
    "token": "abcdefghijklmnqrstuvwxyz", 
    "id": 15
}

XML

<xml>
    <token>abcdefghijklmnqrstuvwxyz</token>
    <id>15</id>
</xml>

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

JSON

{
    "data": {
        "name": "Regular campaign name",
        "is_active": true,
        "data_id": 2,
        "data_type": "segment",
        "content": [
            {
                "subject": "Hi!",
                "from_email": "broadcast@altcraft.com",
                "from_name": "",
                "replyto_email": "broadcast@altcraft.com",
                "replyto_name": "",
                "message_id": 15
            }
        ],
        "send_channel": "email",
        "channel": "email",
        "resource_id": 20,
        "subid": "",
        "limit": 10,
        "aglimit_count": 0,
        "aglimit_percent": 0,
        "start_schedule": {
            "start_mins": [
                10
            ],
            "start_hours": [
                12
            ],
            "start_mdays": [],
            "start_wdays": [],
            "start_months": [],
            "start_years": [],
            "tz": "",
            "profile": false,
            "losers": false
        },
        "for_confirm": false,
        "attributes": {
            "season": "spring_2024",
            "branch": "marketing"
        },
        "policy_id": 0,
        "description": "",
        "virtual_sender_id": 1,
        "is_random_tracking_prefix": false,
        "custom_tracking_domains": [
            "trk.example.com",
            "trk.example.org"
        ],
        "watcher_list_id": 0,
        "watcher_limit": 0,
        "blind_carbon_copy": [],
        "unconditional_sending": false,
        "skip_unique_checking": false,
        "sub_cats_filter": [],
        "sub_fields_filter": null,
        "id": 15,
        "updated_user": "roman",
        "update_time": "2024-04-03T15:35:54.024Z"
    },
    "error": 0,
    "error_text": "Successful operation"
}

XML

<xml>
    <data>
        <aglimit_count>0</aglimit_count>
        <aglimit_percent>0</aglimit_percent>
        <blind_carbon_copy/>
        <channel>"email"</channel>
        <content>
            <from_email>"broadcast@altcraft.com"</from_email>
            <from_name>""</from_name>
            <message_id>15</message_id>
            <replyto_email>"broadcast@altcraft.com"</replyto_email>
            <replyto_name>""</replyto_name>
            <subject>"Hi!"</subject>
        </content>
        <custom_tracking_domains>"trk.example.com"</custom_tracking_domains>
        <custom_tracking_domains>"trk.example.org"</custom_tracking_domains>
        <data_id>2</data_id>
        <data_type>"segment"</data_type>
        <description>""</description>
        <for_confirm>false</for_confirm>
        <id>15</id>
        <is_active>false</is_active>
        <attributes>
            <season>spring_2024</season>
            <branch>marketing</branch>
        </attributes>
        <is_random_tracking_prefix>false</is_random_tracking_prefix>
        <limit>10</limit>
        <name>"Regular campaign name"</name>
        <policy_id>0</policy_id>
        <push_sending_mode>"fanout"</push_sending_mode>
        <resource_id>20</resource_id>
        <send_channel>"email"</send_channel>
        <skip_unique_checking>false</skip_unique_checking>
        <start_schedule>
            <losers>false</losers>
            <profile>false</profile>
            <start_hours>12</start_hours>
            <start_mdays/>
            <start_mins>10</start_mins>
            <start_months/>
            <start_wdays/>
            <start_years/>
            <tz>""</tz>
        </start_schedule>
        <sub_cats_filter/>
        <sub_fields_filter/>
        <subid>""</subid>
        <unconditional_sending>false</unconditional_sending>
        <update_time>"2024-05-20T09:17:53.326Z"</update_time>
        <updated_user>"roman"</updated_user>
        <virtual_sender_id>1</virtual_sender_id>
        <watcher_limit>0</watcher_limit>
        <watcher_list_id>0</watcher_list_id>
    </data>
    <error>0</error>
    <error_text>Successful operation</error_text>
</xml>

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

Параметр	Тип	Описание
error	int	Код ошибки
error_text	string	Текст ошибки
id	int	Идентификатор
name	string	Название рассылки
is_active	bool	Статус рассылки
resource_id	int	Идентификатор ресурса
data_id	int	Идентификатор баз данных или сегмента
data_type	string	Тип источника подписчиков
content	JSON array	Контент, присоединенный к рассылке
send_channel	string	Канал отправки
channel	string	Канал
for_confirm	bool	Имеет ли рассылка сообщения со ссылкой подтверждения
subid	string	subid рассылки
start_shedule	JSON-object	Start schedule object
limit	int	Лимит на каждый запуск
aglimit_count	int	Приращивать лимит по количеству
agllimit_percent	float	Приращивать лимит по проценту
policy_id	int	Идентификатор политики отправки
push_sending_mode	string	Режим отправки push-сообщений (только для push-каналов)
descr	string	Описание рассылки
attributes	object	Атрибуты, назначенные рассылке, и их значения
Smart настройки
virtual_sender_id	int	Идентификатор виртуального сендера Только для smart-аккаунтов
is_random_tracking_prefix	bool	Случайный префикс трекинг-домена Только для smart-аккаунтов
custom_tracking_domains	JSON array	Список произвольных трекинг-доменов Только для smart-аккаунтов
blind_carbon_copy	JSON array	Адреса для скрытой копии Только для smart-аккаунтов
unconditional_sending	bool	Отправка вне зависимости от статуса подписки Только для smart-аккаунтов
watcher_list_id	int	Идентификатор базы наблюдателей Только для smart-аккаунтов
watcher_limit	int	Лимит наблюдателей Только для smart-аккаунтов