Авторизация / Расширенная форма регистрации
 На главную

Авторизация

  • Руководство по интеграции

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

  • Инструкции

  • Расширения

  • Справочники

  • Расширенная форма регистрации

    Как это работает

    Во время регистрации пользователя запрашиваются следующие основные поля:

    • При использовании методов API:
      • Имя пользователя
      • Email
      • Пароль
      Поля имя пользователя и email должны иметь одинаковые значения.
    • При использовании виджета авторизации любой версии:
      • Email
      • Пароль

    При необходимости вы можете запросить у пользователя дополнительные поля.

    Для кого подходит

    Для партнеров, у которых уже подключен продукт Авторизация.

    Как настроить

    Набор доступных полей в расширенной форме регистрации зависят от способа интеграции продукта Авторизация и хранилища, которое вы используете для хранения пользовательских данных. Чтобы настроить форму, выберите способ интеграции и хранилище и следуйте инструкции.

    Интеграция через Login API

    Если вы используете интеграцию через Login API:

    1. Обратитесь к аккаунт-менеджеру проекта и передайте список полей. Для каждого поля укажите:
      1. название;
      2. тип;
      3. является ли обязательным;
      4. название параметра, который будет использоваться при запросе метода API на регистрацию.

    Варианты полей по умолчанию:

    Название поля

    ТипНазвание параметра
    Имя пользователя (всегда обязательное)stringusername
    Имяstringgiven-name
    Фамилияstringfamily-name
    Никнеймstringnickname
    Дата рожденияdate (YYYY-MM-DD)bday
    Полenum (f or m)gender
    Странаselect (ISO 3166-1 alpha-2)country-name
    Подписаться на рассылкуbooleanpromo_email_agreement

    1. В запросе Register new user передайте параметр fields с необходимыми полями.

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

    Copy
    Full screen
    Small screen
    http
    • http
    • curl
    POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
    Content-Type: application/json
    
    {
      "username": "john-email@email.com",
      "password": "123456",
      "email": "john-email@email.com",
      "fields": {
         "nickname": "John",
         "country-name": "US",
         "bday": "1997-07-16"
      }
    }
    curl --request POST \
      --url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
      --header 'content-type: application/json' \
      --data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'

    Интеграции через виджет авторизации

    Если вы используете интеграцию через виджет авторизации любой версии, обратитесь к аккаунт-менеджеру проекта и передайте список полей. Для каждого поля укажите название и является ли оно обязательным.

    Варианты полей по умолчанию:

    • Имя пользователя (всегда обязательное)
    • Имя
    • Фамилия
    • Никнейм
    • Дата рождения
    • Пол
    • Платформа
    • Страна
    • Подписаться на рассылку

    Note
    Если вы используете хранилище Иксолла, поле платформа недоступно.

    Хранилище Иксоллы

    Если вы используете хранилище Иксолла, для использования доступны только перечисленные поля. Значения полей хранятся на стороне Иксоллы.

    Хранилище PlayFab

    Если вы используете хранилище PlayFab, дополнительные поля сохраняются как пользовательские данные в вашем Title PlayFab.

    Помимо перечисленных полей вы можете передать другие поля с указанием следующей информации:

    • название
    • тип:
      • string
      • date
      • select — выбор одного варианта из списка
      • multi-select — выбор нескольких вариантов из списка
    • является ли поле обязательным
    При интеграции через методы API названия полей могут быть любыми. Для полей с типами select и multi-select передайте аккаунт-менеджеру проекта набор возможных значений этих полей.

    Вы можете получить пользовательские данные через PlayFab API или в вашем кабинете Playfab:

    1. Перейдите в раздел Players и нажмите на ID пользователя.

    1. Выберите вкладку Player Data (Title).

    Собственное хранилище

    Если вы используете собственное хранилище, дополнительные поля отправляются в запросе на регистрацию на New user URL.

    Помимо перечисленных полей вы можете передать другие поля с указанием следующей информации:

    • название
    • тип:
      • string
      • date
      • select — выбор одного варианта из списка
      • multi-select — выбор нескольких вариантов из списка
    • является ли поле обязательным
    При интеграции через методы API названия полей могут быть любыми. Для полей с типами select и multi-select передайте аккаунт-менеджеру проекта набор возможных значений этих полей.

    ПРИМЕР

    Были подключены следующие поля:

    • Никнейм
    • Страна
    • Собственное поле platform с типом multi-select и возможными значениями windows, mac os, linux
    При регистрации пользователя на New user URL отправится следующий запрос:

    Copy
    Full screen
    Small screen
    http
    • http
    • curl
    POST https://your.hostname/new_user_url.path HTTP/1.1
    Content-Type: application/json
    Authorization: Bearer {JWT}
    
    {
      "email": "john@gmail.com",
      "password": "123456",
      "country-name": "DE",
      "nickname": "JohnSnow",
      "platform": ["windows", "mac os"]
    }
    curl --request POST \
      --url 'https://your.hostname/new_user_url.path' \
      --header 'authorization: bearer_JWT' \
      --header 'content-type: application/json' \
      --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 9 декабря 2021

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!