Описание API и Callbacks
1. Список рассылок
2. Файлы
3. Шаблоны писем
4. Список подписчиков
5. Подписка на рассылку, отправка сообщения
6. Управление списком групп
7. Управление аккаунтом автора
8. Управление статистикой
Исключение подписчика из рассылки или группы
URL интерфейса: http://api.massdelivery.ru/subscribers.html?action=exclude
Данный API-интерфейс принимает все параметры поиска подписчиков search[]
из интерфейса "4.1 Получение списка подписчиков".
Чтобы исключить нежелательного действия, рекомендутся сперва выполнить запрос к интерфейсу "4.1 Получение списка подписчиков" и удостовериться что выбраны нужные подписчики. После этого заменить параметр action с list
на exclude
,
добавить все необходимые параметры для данного интерфейса (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 | Количество задействованных подписчиков. |