Перейти к основному содержимому
Документация для версии v73

mSDK v2

Описание​

Altcraft mSDK v2.0 — это обновлённый мобильный SDK, который обеспечивает надёжную работу с push-уведомлениями и взаимодействие с платформой Altcraft. Он разработан для Android и iOS, поддерживает Firebase, Huawei, RuStore и APNS, а также предоставляет расширенные возможности по управлению подписками, обработке событий и работе с несколькими пользователями на одном устройстве.

SDK может использовать JWT-токены или rToken, что позволяет гибко настраивать уровень безопасности и типы матчинга данных профилей. Автоматическая обработка уведомлений и событий доставки обеспечивает стабильность и высокую точность передачи данных, а встроенный WorkManager гарантирует доставку событий даже в случае сетевых сбоев.

Altcraft mSDK v2 доступен на GitHub для iOS и Android.

Возможности​

  • Управление подпиской на push-уведомления: добавление, приостановка, отписка.
  • Автоматический показ уведомлений с содержимым, настраиваемым в платформе, с возможностью кастомизации отображения.
  • Автоматическое обновление push-токена при его изменении.
  • Автоматическая передача событий доставки и открытия уведомлений.
  • Поддержка анонимных и зарегистрированных пользователей, а также нескольких пользователей на одном устройстве (при использовании JWT).
  • Регистрация мобильных событий.
  • Автоматический повтор запросов через WorkManager для максимальной доставки событий.
  • Поддержка push-провайдеров: Firebase, Huawei, RuStore (Android), APNS (iOS).
  • Использование JWT-токенов для обеспечения безопасности и неограниченных вариантов матчинга профилей.
  • Возможность работы через rToken с ограниченным доступом по идентификатору push-подписки.
  • Поддержка переопределения формата push-уведомлений и доступа ко всем data-полям сообщений.

Варианты авторизации​

JWT-токен​

Данный тип авторизации использует JWT-токен, который приложение передаёт в SDK. Токен добавляется в заголовок каждого запроса.

JWT (JSON Web Token) — это строка в формате JSON, содержащая claims (набор данных), подписанных для проверки подлинности и целостности.

Токен формируется и подписывается ключом шифрования на стороне серверной части клиента (ключи шифрования не хранятся в приложении). По запросу SDK, приложение обязано передать полученный с сервера JWT-токен.

Преимущества:

  • Повышенная безопасность API-запросов.
  • Возможность поиска профилей по любым идентификаторам (email, телефон, custom ID).
  • Поддержка нескольких пользователей на одном устройстве.
  • Восстановление доступа к профилю после переустановки приложения.
  • Идентификация конкретного профиля на разных устройствах.

rToken​

Альтернативный способ авторизации — использование ролевого токена (rToken), переданного в параметры конфигурации SDK. При этом методе авторизации запросы содержат заголовок с ролевым токеном.

Особенности:

  • Поиск профилей возможен только по push-токену устройства (например, FCM).
  • Если push-токен изменился и не был передан на сервер (например, после удаления и переустановки приложения), связь с профилем будет потеряна/ создастся новый профиль.

Ограничения:

  • Потеря связи с профилем при изменении push-токена, которое не было зафиксировано на сервере Altcraft.
  • Отсутствие возможности использовать приложение для разных профилей на одном устройстве.
  • Невозможность регистрации одного пользователя на другом устройстве.
Последнее обновление