/auth/mobile

Метод используется для авторизации пользователя через мобильное приложение (Android).

Адрес метода

/auth/mobile

Тестовый пользователь

Для авторизации под тестовым пользователем, необходимо создать тестового пользователя в панели управления и использовать его "Ключ авторизации" как значение параметра data

Параметры

Параметр Обязательный Тип Описание
type ДА int Тип мобильной авторизации: 1 - Android Guest, 2 - iOS Guest, 3 - Google
data ДА string Строка с данными авторизации для указанного типа

Device context (необязательные)

Параметр Тип Описание
push_token string Токен устройства для native push-уведомлений (FCM на Android, APNs на iOS). Платформа определяется по параметру type или app_platform. Пустая строка сбрасывает сохранённый токен
app_platform string Платформа приложения (например: ios, android)
distribution string Канал дистрибуции (например: appstore, googleplay)
app_version string Версия приложения (например: 1.2.3)
os_version string Версия операционной системы (например: 17.0)
device_model string Модель устройства (например: iPhone 15)
language_code string Локаль игры (ru-RU, en). Сохраняется как код языка пушей. Неизвестный тег игнорируется, авторизация при этом проходит

Токен push-уведомлений обновляется при каждой авторизации, если параметр push_token передан в запросе. Если платформу не удалось определить по type и app_platform, непустой токен не сохраняется — авторизация при этом завершается успешно.

Attribution / AppsFlyer (необязательные)

Данные Attribution сохраняются один раз — повторные авторизации не перезаписывают уже сохранённые значения.

Параметр Тип Описание
appsflyer_id string AppsFlyer Device ID
media_source string Источник трафика (media source)
campaign string Название кампании
adset string Название группы объявлений (adset)
ad string Название объявления (ad)
gaid string Google Advertising ID

Результат

Данный метод в результате выполнения возвращает токен пользователя и его профиль. Токен используется для авторизации запросов от имени пользователя - подробнее.

{
    "response": {
        "token": "......",
        ...member
    }
}
Поле Тип Описание
token string Содержит строку с идентификатором сессии пользователя
...member * Объект пользователя

events

Если во время авторизации была применена миграция профиля или у игрока есть непросмотренные компенсации, ответ может содержать блок events.

{
    "response": {
        "token": "......",
        "...member": {}
    },
    "events": [
        {
            "type": "migration",
            "payload": {
                "id": "profile.1.0.0.gacha_synth_sphere_to_token",
                "from_version": "0.100.0",
                "to_version": "1.0.0",
                "result": {
                    "type": "conversion",
                    "spent": [
                        { "type": "synthSphere", "amount": 250 }
                    ]
                }
            }
        },
        {
            "type": "reward",
            "payload": {
                "reasonType": "migration",
                "reasonId": "profile.1.0.0.gacha_synth_sphere_to_token",
                "rewards": [
                    { "type": "token", "amount": 3 }
                ]
            }
        },
        {
            "type": "reward",
            "payload": {
                "reasonType": "compensation",
                "reasonId": 12,
                "content": "{\"title\":\"test\",\"ru\":\"Компенсация за ошибку\",\"en\":\"Bug compensation\"}",
                "rewards": [
                    { "type": "hard", "amount": 100 }
                ]
            }
        }
    ]
}