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

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

Описание

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

URL-адрес

Метод: POST

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

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

ПараметрТипПримерОбязательныйОписание
tokenstring"abcdefghijklmnqrstuvwxyz"ДаAPI токен
formatstring"json"НетФормат возвращаемых данных
(по умолчанию – "json")
resource_idint1ДаИдентификатор ресурса
db_idint1НетИдентификатор базы данных
channelstring"email"НетТип канала
statusstring"subscribed"НетСтатус подписки
from_idstring"60df2b6325bf0aa04e22e8f5"НетИдентификатор первого профиля в списке
limitint1НетЛимит на количество возвращаемых данных

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

{
"db_id": 1,
"from_id": "60df2b6325bf0aa04e22e8f5",
"limit": 1,
"resource_id": 1,
"token": "abcdefghijklmnqrstuvwxyz"
}

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

{
"data": [
{
"_xxh": "12345",
"channel": "email",
"db_id": 1,
"email": "john@example.com",
"hash_id": "12345",
"priority": 0,
"profile_id": "60df2b6325bf0aa04e22e8f5",
"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",
"next_from_id": "3hDmNCv1E3pT62kP8EqdDZN77jmF9RW82p1rFvpui5wxUMdq2EYQJkg",
"total_count": 1
}

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

ПараметрТипОписание
errorintКод ошибки
error_textstringТекст ошибки
next_from_idstringУказатель необходимо передать в следующем запросе для получения еще одной порции данных, до тех пор пока вывод результата не будет содержать 0 строчек истории
resource_idintИдентификатор ресурса, связанного с подпиской
channelstringТип канала
custom_fieldsobjectСтандартные и дополнительные поля подписки.

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

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

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

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

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

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

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

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

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

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

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