Перейти к основному содержимому
Altcraft Docs LogoAltcraft Docs Logo
Для пользователяДля разработчикаДля администратора
Веб-сайтБаза знаний
Русский
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Войти
  • API пользователя
  • Взаимодействие с API
  • Матчинг
  • Профили
    • Импортировать профиль
    • Обновить профиль
    • Добавить профиль в базу данных
    • Получить информацию о профиле
    • Импортировать профиль в RabbitMQ
    • Массовое добавление профилей в базу данных
    • Массовое обновление профилей
    • Массовый импорт профилей
    • Приостановить все профили в базе данных
    • Восстановить все приостановленные профили в базе данных
    • Удалить профиль
    • Упрощенный импорт профиля
    • Функциональное обновление полей базы
    • Функциональное обновление полей подписки
    • Выгрузка профилей в файл
    • Получение данных по нескольким профилям
    • Объединение нескольких профилей
    • Отписать профиль от ресурса
    • Разделение профиля
    • История
    • Связи профилей
    • Подписки
      • Добавить или редактировать подписку
      • Получить все подписки профиля
      • Получить все подписки нескольких профилей
      • Получить информацию о подписке профиля
      • Удалить подписку профиля
      • Восстановить удаленную подписку профиля
      • Приостановить все подписки
      • Восстановить все приостановленные подписки
  • Базы данных
  • Ресурсы
  • Сегменты
  • Стоп-списки
  • Шаблоны
  • Рассылки
  • Кампании
  • Сценарии (цепочки)
  • Промокоды
  • Программы лояльности
  • Цели
  • Пуши приложений
  • Маркет
  • Отчеты и статистика
  • Сендеры
  • Объекты
  • Запросы к внешним базам данных
  • Прочее
  • Список API-методов
  • Импорт и настройка коллекции API-методов в Postman
  • SDK
  • Профили
  • Подписки
  • Получить все подписки профиля
Документация для версии v74

Получить все подписки профиля

Описание​

Получить все подписки одного профиля.

URL-адрес​

Метод: POST

https://example.com/api/v1.1/subscriptions/list

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

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
db_idint1ДаИдентификатор базы данных
formatstring"json"НетФормат возвращаемых данных
(по умолчанию – "json")
profile_idstring"abcdefghijklmnqrstuvwxyz"ДаИдентификатор профиля

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

  • JSON
  • XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"db_id": 1,
"profile_id": "abcdefghijklmnqrstuvwxyz"
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<db_id>1</db_id>
<profile_id>abcdefghijklmnqrstuvwxyz</profile_id>
</xml>

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

  • JSON
  • XML
{
"data": [
{
"resource_id": 29,
"channel": "email",
"email": "example@example.com",
"priority": 10,
"status": "suspended",
"custom_fields": {
"custom_int_field_2": 20000
}
}
],
"error": 0,
"error_text": "Successful operation"
}
<xml>
<data>
<channel>email</channel>
<custom_fields>
<custom_int_field_2>20000</custom_int_field_2>
</custom_fields>
<email>example@example.com</email>
<priority>10</priority>
<resource_id>29</resource_id>
<status>suspended</status>
</data>
<error>0</error>
<error_text>Successful operation</error_text>
</xml>

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

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
channelstringТип канала (email, push или sms)
priorityintПриоритет подписки
(меньше число – больше приоритет)
resource_idintИдентификатор ресурса, связанного с подпиской
statusstringСтатус подписки
custom_fieldsobjectСтандартные и дополнительные поля подписки.

Получить информацию о полях подписки в ресурсе можно с помощью метода /v1.1/resources/fields_get
catsarrayКатегории ресурса, на которые подписан профиль

Дополнительно для Email-канала:

ПараметрыТипОписание
emailstringEmail-адрес

Дополнительно для PUSH-канала:

ПараметрыТипОписание
providerstringТип провайдера
subscription_idstringИдентификатор подписки

Дополнительно для SMS-канала:

ПараметрыТипОписание
phonestringНомер телефона

Дополнительно для Telegram-канала:

ПараметрыТипОписание
cc_dataobjectid чата в Telegram-бот

Дополнительно для WhatsApp*-канала:

ПараметрыТипОписание
cc_dataobjectТелефон профиля в WhatsApp*

*Организация Meta, которой принадлежат продукты Instagram, Facebook и WhatsApp, признана экстремистской и запрещена на территории РФ.

Последнее обновление 16 мая 2024 г.
Предыдущая страница
Добавить или редактировать подписку
Следующая страница
Получить все подписки нескольких профилей
  • Описание
  • URL-адрес
  • Параметры запроса
  • Пример запроса
  • Пример ответа
  • Возвращаемые параметры
© 2015 - 2025 Altcraft. Все права защищены.