Как интегрировать Личный кабинет пользователя
Как это работает
Личный кабинет дает вашим пользователям возможность управлять следующими данными:
- аватар;
- номер телефона;
- email;
- ник;
- имя и фамилия;
- дата рождения;
- пол;
- список друзей (только через методы API).
Возможны два варианта интеграции Личного кабинета пользователя:
- С интерфейсной частью через URL. Интерфейс Личного кабинета пользователя локализуется на 20 языков и адаптируется под разрешение экрана.
- Без интерфейсной части через методы API. Вы можете использовать собственный интерфейс для управления данными пользователей.
Для кого подходит
Для партнеров, у которых уже подключен продукт Авторизация.
Как настроить
Выберите способ интеграции Личного кабинета пользователя и следуйте инструкциям ниже.
Интеграция через URL
- Сгенерируйте URL для открытия Личного кабинета пользователя.
- Настройте переход к Личному кабинету пользователя по URL.
- Настройте обработку событий (опционально).
Генерация URL
Личный кабинет пользователя открывается по URL https://useraccount.xsolla.com/profile с параметрами, описанными в таблице.
| Параметр | Тип | Описание |
|---|---|---|
locale | string | Query-параметр. Язык интерфейса Личного кабинета пользователя. Принимает значения в соответствии со стандартом ISO 639-1. |
token | string | Hash-параметр. JWT пользователя. Параметр передается в URL после успешной аутентификации. Обязательный. |
Пример URL:
- http
https://useraccount.xsolla.com/profile?locale=de#token=XXXXНастройка перехода по URL
Вы можете открыть Личный кабинет пользователя по URL следующими способами:
- в iframe на вашем сайте,
- в новой вкладке браузера.
IFRAME
Добавьте на страницу сайта, где открывается Личный кабинет пользователя, следующий скрипт: <iframe src="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">, где src — сгенерированный URL.
Новая вкладка браузера
Разместите URL в объекте вашего интерфейса, при нажатии на который открывается Личный кабинет пользователя.
Например, добавьте на сайт следующий скрипт: <a href="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">Your account</a>, где src — сгенерированный URL.
Настройка обработки событий (опционально)
Если Личный кабинет пользователя открывается в iframe, в зависимости от действий пользователя в родительское окно отправляются события. Для отправки используется механизм postMessage.
| Название события | Описание |
|---|---|
| user-account-close | Пользователь нажал на крестик, чтобы закрыть Личный кабинет пользователя. |
| user-account-loaded | Личный кабинет пользователя загружен, не удалось получить данные. |
| user-account-page-fetched | Личный кабинет и данные пользователя загружены. |
Для обработки событий необходимо добавить на сайт метод addEventListener и функциональный скрипт.
Пример обработки события:
- js
window.addEventListener('message', (event) => {
if (event.data.command === 'user-account-loaded') {
// your script
}
})
Интеграция через методы API
Для управления данными пользователей через методы API вам необходимо реализовать интерфейс и вызов методов. Подробное описание методов API с примерами кода приведено в документации.
Была ли статья полезна?
Оценить страницу
В другой раз
Спасибо за обратную связь!
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
