Como integrar a User Account
Como funciona
Seus usuários podem gerenciar os seguintes dados por meio de sua conta:
- foto de perfil
- telefone
- apelido
- nome e sobrenome
- data de nascimento
- gênero
- lista de amigos (disponível apenas via API).
Você pode integrar a User Account de uma das seguintes maneiras:
- Com uma interface via URL. A interface da User Account é localizada em 20 idiomas e se ajusta à resolução da tela.
- Sem uma interface via API. Dessa forma, você pode implementar sua própria interface para gerenciar dados do usuário.
Quem pode usar
Parceiros que já integraram o Login.
Como obtê-lo
Selecione a maneira pela qual você deseja integrar a User Account e siga as instruções abaixo.
Integração via URL
- Gere um URL para abrir uma User Account.
- Configure a abertura da User Account no URL gerado.
- Configure o processamento de eventos (opcional).
Gerar URL
A User Account é aberta emhttps://useraccount.xsolla.com/profile
com os parâmetros descritos nesta tabela.Parâmetro | Tipo | Descrição |
---|---|---|
localidade | string | Parâmetro de consulta. Idioma da interface da User Account. Idiomas suportados: Inglês (en) (padrão), Árabe (ar), Búlgaro (bg), Tcheco (cs), Alemão (de), Espanhol (es), Francês (fr), Hebraico (he), Italiano (it), Japonês (ja), Coreano (ko), Polonês (pl), Português (Brasil) (pt), Romeno (ro), Russo (ru), Tailandês (th), Turco (tr), Vietnamita (vi), Chinês simplificado (cn), Chinês Tradicional (tw). |
token | string | Parâmetro de hash. JWT de usuário. Passado no URL após a autenticação bem-sucedida. Obrigatório. |
- http
https://useraccount.xsolla.com/profile?locale=de#token=XXXX
Configuração da abertura da User Account no URL
Você pode configurar a abertura da User Account em um URL específico das seguintes maneiras:
- em um iframe em seu site
- em uma nova aba
IFRAME
Adicione o seguinte script à página da web onde você deseja abrir a User Account: <iframe src=“https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">
, onde src
é o URL gerado.
NOVA ABA
Adicione um URL ao objeto de interface que leva à User Account.
Você pode usar o seguinte script: <a href=“https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">Your account</a>
, onde src
é o URL gerado.
Configuração do processamento de eventos (opcional)
Se a User Account for aberta em um iframe, a janela pai obterá eventos postMessage de acordo com as ações do usuário na conta.Nome do evento | Descrição |
---|---|
user-account-close | O usuário clica no botão de saída e fecha a User Account. |
user-account-loaded | A User Account é carregada, mas os dados do usuário não podem ser obtidos. |
user-account-page-fetched | A User Account e os dados do usuário são carregados com êxito. |
Para processar esses eventos, adicione o método addEventListener
e seu script ao site.
Exemplo de processamento de eventos:
- javascript
window.addEventListener('message', (event) => {
if (event.data.command === 'user-account-loaded') {
// your script
}
})
Integração via chamadas de API
Para gerenciar dados do usuário via API, implemente sua própria interface e permita chamadas de solicitações de API. Você encontrará a descrição detalhada das chamadas de API disponíveis e exemplos de código em nossa documentação.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.