Перейти к основному содержимому

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

Описание

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

URL-адрес

Метод: POST

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

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

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

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

{
"db_id": 1,
"profile_id": "abcdefghijklmnqrstuvwxyz",
"token": "abcdefghijklmnqrstuvwxyz"
}

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

{
"data": [
{
"channel": "email",
"email": "john@example.com",
"priority": 0,
"resource_id": 1,
"status": "subscribed",
"custom_fields": {
"_browser_name": "Firefox",
"_device_type": "web",
"custom_field_1": "test value"
},
"cats": [
"category_1",
"category_2"
]
}
],
"error": 0,
"error_text": "Successful operation"
}

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

ПараметрТипОписание
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