Метод updateList

Skip to main content

Метод для изменения свойств списка рассылки.

Принцип использования

Синтаксис и URL для вызова метода
updateList (int list_id, [string title, string before_subscribe_url, string after_subscribe_url, array sub_user_rights])
https://api.unisender.com/ru/api/updateList?format=json&api_key=KEY&list_id=ID&title=NewListName
Аргументы
api_key * Ключ доступа к API.
list_id * Код списка, полученный методом getLists или createList.
title * Название списка. Должно быть уникальным в вашем аккаунте.

Примеры:

title=NewListTitle

title=%D0%9D%D0%BE%D0%B2%D1%8B%D0%B9

 («Новый» в кодировке UTF-8)

before_subscribe_url URL для редиректа на страницу "перед подпиской". Обычно на этой странице показывается сообщение, что контакту надо перейти по ссылке подтверждения для активации подписки. В этот URL можно добавлять поля подстановки - например, вы можете идентифицировать контакта по email-адресу, подставив сюда email - либо по коду контакта в своей базе данных, сохраняя код в дополнительное поле и подставляя его в этот URL.
after_subscribe_url URL для редиректа на страницу "после подписки". Обычно на этой странице показывается сообщение, что подписка успешно активирована. В этот URL можно добавлять поля подстановки - например, вы можете идентифицировать контакта по email-адресу, подставив сюда email - либо по коду контакта в своей базе данных, сохраняя код в дополнительное поле и подставляя его в этот URL.
sub_user_rights[<sub_user_id>][<right>] Права доступа к списку для дополнительных пользователей аккаунта (не более 10 дополнительных пользователей на один запрос). Параметр доступен только для дополнительных пользователей, у которых включена настройка «Индивидуальная настройка доступа к избранным спискам».

<right> может принимать значения: access, send_email, send_sms.

— Для access доступны значения: view_stats, view, manage, none (none — удаляет у дополнительного пользователя доступ к списку).

— Для send_email и send_sms доступны значения: 0, 1.

Возвращаемое значение
Пустой объект JSON
Если были ошибки или предупреждения, они возвращаются в полях error/warnings в соответствии с описанием.

Читайте также

Вы нашли ответ?