Регистрация

Операции регистрации создают мастер-аккаунт и подтверждают шестизначный код, если проверка почты включена настройками проекта или политикой проверки адресов.

Регистрация по email

MutationdocumentId: registerEmailauth: public

registerEmail

Описание

Регистрирует пользователя по email. При необходимости операция также может создать игровой аккаунт на выбранном сервере.

Входные данные

Поле	Тип	Обязательный	Описание
email	String!	✓	Email пользователя
password	String!	✓	Пароль (6-16 символов)
terms	Boolean!	✓	Принятие условий
login	String	-	Логин игрового аккаунта (4-14 символов)
prefix	String	-	Префикс логина (3 символа)
serverId	Int	-	ID сервера для создания аккаунта
utm	JSON	-	UTM-метки
promoGame	JSON	-	Данные промо-игры

Результат

Тип ответа - LoginResult. Если подтверждение обязательно, user и sessionId равны null, а message сообщает об отправке кода. Без подтверждения операция сразу возвращает пользователя и созданную сессию.

Ошибки

• VALIDATION - некорректный email, пароль, логин или условия не приняты.
• EMAIL_EXISTS - email уже зарегистрирован.
• GAME_ACCOUNT_EXISTS - игровой логин уже занят.
• REGISTRATION_DISABLED - регистрация отключена в проекте.

Пример обмена

Запрос

documentId: registerEmail

{
  "documentId": "registerEmail",
  "variables": {
    "email": "[email protected]",
    "password": "password123",
    "login": "GameLogin",
    "prefix": "abc",
    "serverId": 1,
    "terms": true,
    "utm": {
      "source": "site",
      "medium": "web",
      "campaign": "launch"
    },
    "promoGame": {}
  }
}

Ответ

200 OK

{
  "data": {
    "registerEmail": {
      "sessionId": null,
      "sessionEnd": null,
      "user": null,
      "twoFactorChallenge": null,
      "message": "Код подтверждения отправлен на почту"
    }
  }
}

Связанные типы

RegisterEmailInputLoginResultUserResult

Подтверждение кода регистрации

MutationdocumentId: confirmRegistrationCodeauth: public

confirmRegistrationCode

Описание

Проверяет код, завершает отложенную регистрацию и создаёт подтверждённый аккаунт. Код привязан к почте, команде и проекту и принимается только один раз.

Входные данные

Поле	Тип	Обязательный	Описание
email	String!	✓	Email, указанный при регистрации
code	String!	✓	Шестизначный код подтверждения

Результат

Тип ответа - UserResult.

Ошибки

• VALIDATION - email или код не переданы.
• INVALID_CODE - код неверный или истек.
• USER_NOT_FOUND - пользователь с таким email не найден.

Пример обмена

Запрос

documentId: confirmRegistrationCode

{
  "documentId": "confirmRegistrationCode",
  "variables": {
    "email": "[email protected]",
    "code": "123456"
  }
}

Ответ

200 OK

{
  "data": {
    "confirmRegistrationCode": {
      "user": {
        "id": "1001",
        "email": "[email protected]",
        "emailConfirmed": true
      },
      "message": "Регистрация подтверждена"
    }
  }
}

Связанные типы

ConfirmCodeInputUserResult