Skip to content

Проверка статуса подписки

Метод возвращает информацию о текущих статусах подписок клиента на тип и канал рассылки.

Независимо от того, какой идентификатор клиента передан, проверяются все типы и каналы.

GET https://api.rees46.ru/subscriptions/check

Параметры

ПараметрОбязателен?Описание
shop_idДаAPI-ключ
shop_secretДаСекретный API-ключ
email*ДаEmail клиента
phone*ДаТелефон клиента
did*ДаИдентификатор устройства

Идентификаторы

Параметры, отмеченные [*] — обязателен хотя бы один из них. На стороне сайта или мобильных приложений SDK автоматически передает did.

Запрос

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

shell
curl 'https://api.rees46.ru/subscriptions/check?shop_id=...&shop_secret=...&email=...'
javascript
r46('subscription', 'check',
  function (subscriptions) {
    console.log(subscriptions)
  },
  function(error) {
    console.log(error)
  }
);
swift
// Пока не реализовано
kotlin
// Пока не реализовано
javascript
// Пока не реализовано

Ответ

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

json
{
  "exists": false,
  "email_bulk": false,
  "email_chain": false,
  "email_transactional": false,
  "email_invalid": false,
  "email_blacklisted": false,
  "email_bounced": false,
  "email_suppressed": false,
  "email_confirmed": false,
  "web_push_bulk": false,
  "web_push_chain": false,
  "web_push_transactional": false,
  "mobile_push_bulk": false,
  "mobile_push_chain": false,
  "mobile_push_transactional": false,
  "sms_bulk": false,
  "sms_chain": false,
  "sms_transactional": false,
  "telegram_bulk": false,
  "telegram_chain": false,
  "telegram_transactional": false,
  "whatsapp_bulk": false,
  "whatsapp_chain": false,
  "whatsapp_transactional": false,
  "max_bulk": false,
  "max_chain": false,
  "max_transactional": false,
  "wallet_bulk": false
}

Расшифровка свойств ответа:

СвойствоТипОписание
existsBooleanСуществует ли клиент с таким идентификатором в CDP?
email_bulkBooleanЕсть ли у пользователя email и подписка на массовую рассылку
email_chainBooleanЕсть ли у пользователя email и подписка на триггерную рассылку
email_transactionalBooleanЕсть ли у пользователя email и подписка на транзакционную рассылку
email_invalidBooleanФлаг, что email невалиден
email_blacklistedBooleanФлаг, что email в черном списке
email_bouncedBooleanФлаг, что email bounced (не существует)
email_suppressedBooleanФлаг, что email заблокирован (нельзя менять статус подписки)
email_confirmedBooleanФлаг, что email подтвержден
web_push_bulkBooleanЕсть ли у пользователя web push токен и подписка на массовую рассылку
web_push_chainBooleanЕсть ли у пользователя web push токен и подписка на триггерную рассылку
web_push_transactionalBooleanЕсть ли у пользователя web push токен и подписка на транзакционную рассылку
mobile_push_bulkBooleanЕсть ли у пользователя mobile push токен и подписка на массовую рассылку
mobile_push_chainBooleanЕсть ли у пользователя mobile push токен и подписка на триггерную рассылку
mobile_push_transactionalBooleanЕсть ли у пользователя mobile push токен и подписка на транзакционную рассылку
sms_bulkBooleanЕсть ли у пользователя номер телефона и подписка на массовую SMS рассылку
sms_chainBooleanЕсть ли у пользователя номер телефона и подписка на триггерную SMS рассылку
sms_transactionalBooleanЕсть ли у пользователя номер телефона и подписка на транзакционную SMS рассылку
telegram_bulkBooleanЕсть ли у пользователя Telegram и подписка на массовую рассылку
telegram_chainBooleanЕсть ли у пользователя Telegram и подписка на триггерную рассылку
telegram_transactionalBooleanЕсть ли у пользователя Telegram и подписка на транзакционную рассылку
whatsapp_bulkBooleanЕсть ли у пользователя WhatsApp и подписка на массовую рассылку
whatsapp_chainBooleanЕсть ли у пользователя WhatsApp и подписка на триггерную рассылку
whatsapp_transactionalBooleanЕсть ли у пользователя WhatsApp и подписка на транзакционную рассылку
max_bulkBooleanЕсть ли у пользователя MAX и подписка на массовую рассылку
max_chainBooleanЕсть ли у пользователя MAX и подписка на триггерную рассылку
max_transactionalBooleanЕсть ли у пользователя MAX и подписка на транзакционную рассылку
wallet_bulkBooleanЕсть ли у пользователя Wallet и подписка на массовую рассылку

В случае ошибки ответ будет в формате:

json
{
  "status": "error",
  "payload": {
    "message": "Invalid secret key"
  }
}