Описание API и Callbacks
1. Список рассылок
2. Файлы
3. Шаблоны писем
4. Список подписчиков
5. Подписка на рассылку, отправка сообщения
6. Управление списком групп
7. Управление аккаунтом автора
8. Управление статистикой
Включение подписчика в рассылку или группу
URL интерфейса: http://api.massdelivery.ru/subscribers.html?action=include
Данный API-интерфейс принимает все параметры поиска подписчиков search[]
из интерфейса "4.1 Получение списка подписчиков".
Чтобы исключить нежелательного действия, рекомендутся сперва выполнить запрос к интерфейсу "4.1 Получение списка подписчиков" и удостовериться что выбраны нужные подписчики. После этого заменить параметр action с list
на include
,
добавить все необходимые параметры для данного интерфейса (goal и т.д.) и выполнить запрос.
Будьте предельно внимательны, без выборки будет задействован весь список подписчиков.
id | ID подписчика для включения в рассылку или группу. |
search | Критерии фильтра поиска для выборки нужных подписчиков. Необходимо указывать search [ нужный критерий ] 1. date_from и date_to - дата добавления подписчика в ваш список. Формат даты: д/м/гггг 2. email - Email-адреc подписчика 3. email_state - статус email-адреса. (active - активный, activation - активирующийся, disabled - несуществующий, fbl - спам) 4. name_first - имя подписчика 5. name_last - фамилия подписчика 6. name_mid - отчество подписчика 7. birth_day, birth_month и birth_year - день, месяц и год рождения подписчика 8. country_id - страна подписчика 9. city - город подписчика 10. address - адрес подписчика 11. sex - пол подписчика: (m - мужчина, w - женщина) 12. phones - любые контактные данные подписчика 13. deliveries_ids - рассылки на которые подписан подписчик 14. queue - статус получения писем рассылки (0 - свободные от получения писем, 1 - в процессе получения) 13. groups_ids - группы в которые включен подписчик |
goal | Цель действия.
|
delivery_id | ID рассылки для включения в нее подписчика. Через запятую можно перечислить несколько ID. |
group_id | ID группы для включения в нее подписчика. Через запятую можно перечислить несколько ID. |
{ "result":1, "subscribers_count":"1" }
result |
Результат исполнения запроса.
|
subscribers_count | Количество задействованных подписчиков. |