E-mail i hasło

Konto gracza z adresem e-mail i hasłem: rejestracja, logowanie, weryfikacja adresu i reset hasła.

Rejestracja#

[Serializable] public class SignUpRequest { public string email; public string password; public string displayName; public string locale; }

var request = new SignUpRequest { email = "gracz@example.com", password = "Haslo12345", displayName = "Gracz", locale = "pl" };
yield return Post("/email/sign-up", JsonUtility.ToJson(request), null, body =>
{
    var auth = JsonUtility.FromJson<AuthResponse>(body);
    PlayerPrefs.SetString("nunox_session", auth.sessionToken);
}, (status, body) => Debug.LogError($"Błąd {status}: {body}"));

const auth = await call("/email/sign-up", {
    email: "gracz@example.com",
    password: "Haslo12345",
    displayName: "Gracz",
    locale: "pl",
});

curl -X POST https://player-auth.services.api.sandbox.gamevious.com/v1/authentication/email/sign-up \
  -H "Content-Type: application/json" -H "X-Project-Id: prj_gv_…" -H "X-Environment: env_gv_…" \
  -d '{"email":"gracz@example.com","password":"Haslo12345","displayName":"Gracz","locale":"pl"}'

Odpowiedź zawiera tokeny (gracz jest od razu zalogowany) i pole verificationEmailSent - przy rejestracji usługa wysyła link potwierdzający adres, z szablonu ustawionego w panelu.

Jeśli polityka haseł działa w trybie „Powiadamiaj”, słabe hasło jest przyjmowane, a odpowiedź zawiera passwordPolicyViolations - możesz wtedy zachęcić gracza do zmiany hasła.

Logowanie#

[Serializable] public class SignInRequest { public string email; public string password; }

yield return Post("/email/sign-in", JsonUtility.ToJson(new SignInRequest { email = email, password = password }), null, body =>
{
    if (body.Contains("\"mfaRequired\":true")) { /* drugi krok - kod SMS */ return; }
    var auth = JsonUtility.FromJson<AuthResponse>(body);
    PlayerPrefs.SetString("nunox_session", auth.sessionToken);
}, (status, body) => Debug.LogError($"Błąd {status}: {body}"));

const result = await call("/email/sign-in", { email, password });

if (result.mfaRequired) {
    // drugi krok - kod SMS (result.mfaPendingCredential, result.factors)
} else {
    localStorage.setItem("nunox_session", result.sessionToken);
}

curl -X POST https://player-auth.services.api.sandbox.gamevious.com/v1/authentication/email/sign-in \
  -H "Content-Type: application/json" -H "X-Project-Id: prj_gv_…" -H "X-Environment: env_gv_…" \
  -d '{"email":"gracz@example.com","password":"Haslo12345"}'

Jeśli gracz ma włączoną weryfikację dwuetapową, zamiast tokenów przychodzi mfaRequired: true - gra prosi wtedy o kod SMS.

Weryfikacja adresu e-mail#

Link weryfikacyjny wychodzi automatycznie przy rejestracji. Gracz może poprosić o kolejny (zalogowany, z idToken):

curl -X POST https://player-auth.services.api.sandbox.gamevious.com/v1/authentication/email/verification \
  -H "Content-Type: application/json" -H "X-Project-Id: prj_gv_…" -H "X-Environment: env_gv_…" \
  -H "Authorization: Bearer <idToken>" -d '{"locale":"pl"}'

Link jest ważny 24 godziny, a nowy unieważnia poprzedni. Po potwierdzeniu player.emailVerified ma wartość true, a stan konta verified.

Reset hasła#

curl -X POST https://player-auth.services.api.sandbox.gamevious.com/v1/authentication/password/reset \
  -H "Content-Type: application/json" -H "X-Project-Id: prj_gv_…" -H "X-Environment: env_gv_…" \
  -d '{"email":"gracz@example.com","locale":"pl"}'

Odpowiedź to zawsze {"sent": true}, także dla nieistniejącego adresu (ochrona przed wyliczaniem). Link jest ważny godzinę. Po zmianie hasła pozostałe sesje gracza są unieważniane, jeśli w Ustawieniach włączono „Wyloguj z innych urządzeń po zmianie hasła”.

Gdzie prowadzą linki z e-maili#

Domyślnie link prowadzi na stronę Gamevious, na której gracz potwierdza adres albo ustawia nowe hasło. Jeśli wolisz własną stronę, ustaw w panelu w szablonie Własny adres akcji, np. https://twojagra.pl/auth/action. Link dostaje wtedy parametry:

Twoja strona kończy akcję przez API:

{ "oobCode": "…" }   // potwierdzenie adresu

{ "oobCode": "…", "newPassword": "NoweHaslo123" }