Для привязки пуш-устройства к получателю используется метод api/push/device/registration
. Он позволяет отправлять пуш-уведомления по идентификатору получателя и запускать каскадные рассылки из нескольких каналов.
Перед вызовом метода убедитесь, что в настройках пуш-приложения установлен ручной способ регистрации устройств.
Вызов метода api/push/device/registration
Чтобы вызвать метод api/push/device/registration
, отправьте POST-запрос на URL-адрес https://app.edna.ru/api/push/device/registration
.
Если запрос выполнен успешно, метод возвращает ответ с кодом 200
.
Формат тела запроса
{ "subscriber": { "address": "79001002030", "type": "PHONE" }, "deviceAppInfo": { "deviceAddress": "gcmfptwlc8lv1ahl28hannuesjj98yqodl", "deviceUID": "2d9dd0c275bc9a240c00bcd8a46120c53c840f91", "deviceName": "test22", "systemName": "HUAWEI ANE-LX1", "appPackage": "com.edna.e2e.load.saas.e2e.gcm.app1_c6b91927-0d8e-4f43-a507-c3f216c56319", "locale": "RU", "timezone": "Europe/Moscow", "notificationAlertAllowed": true, "notificationDelayedViewEnabled": false, "timeSensitiveNotificationAllowed": false } }
Параметры запроса
Параметр | Тип данных | Характер | Описание |
subscriber | object | Необязательный | Получатель сообщения. Может включать идентификатор получателя в edna Pulse, номер телефона получателя или другие необходимые идентификаторы. |
subscriber. address | string | Обязательный | Значение типа идентификатора, указанного в параметре type .Например, если в параметре type указано PHONE , то в параметре address будет номер телефона клиента. |
subscriber. type | string | Обязательный | Тип идентификатора получателя. Значения указываются в верхнем регистре. Возможные значения: • INSTAGRAM_ID *• FACEBOOK_ID *• PHONE • EMAIL • UTM • COOKIE_ID • TELEGRAM_ID • GOOGLE_ID • APPLE_ID • YANDEX_ID • EXT_USER_ID |
deviceAppInfo | object | Необязательный | Данные устройства пользователя. |
deviceAppInfo. deviceAddress | string | Обязательный | Уникальный пуш-адрес устройства пользователя edna Pulse. Приходит в колбэке от мобильных пуш-библиотек edna Pulse: • EDNAPushXDeviceInfo — для iOS.• onDeviceAddressChanged — для Android.Меняется вместе с изменением токенов в пуш-облаках. Также используется как DEVICE_APP_ID . |
deviceAppInfo. deviceUID | string | Обязательный | Уникальный идентификатор устройства пользователя. Остается постоянным до переустановки приложения пользователем. |
deviceAppInfo. deviceName | string | Необязательный | Имя устройства, установленное пользователем. |
deviceAppInfo. systemName | string | Необязательный | Название модели устройства пользователя. |
deviceAppInfo. appPackage | string | Обязательный | Имя пакета приложения. |
deviceAppInfo. locale | string | Необязательный | Язык интерфейса на устройстве пользователя. Пример формата — RU . |
deviceAppInfo. timezone | string | Необязательный | Временная зона, установленная на устройстве пользователя. Пример формата — Europe/Moscow . |
deviceAppInfo. notificationAlertAllowed | boolean | Необязательный | Разрешение на отображение уведомлений для приложения. Возможные значения: • true — отображение разрешено;• false — отображение запрещено. |
deviceAppInfo. notificationDelayedViewEnabled | boolean | Необязательный | Наличие приложения в сводке уведомлений. Только для iOS. Возможные значения: • true — приложение есть в сводке;• false — приложения нет в сводке. |
deviceAppInfo. timeSensitiveNotificationAllowed | boolean | Необязательный | Разрешение на отображение чувствительных ко времени уведомлений. Только для iOS. Возможные значения: • true — отображение разрешено;• false — отображение запрещено. |
* Деятельность компании Meta запрещена на территории Российской Федерации.