Xsolla-logo

Autenticação por ID personalizadoServer-side

post/users/login/server_custom_id

Autentica um usuário por uma ID personalizada específica. Se o usuário não existir, ele será criado.

SecurityServer
Request
query Parameters
projectId
string <uuid>

Faça login no ID do projeto na Conta de Distribuidor. Se você não especificá-lo, o Shadow Login será usado para o parâmetro publisher_project_id especificado.

Shadow Login ID que você não precisa passar para esta chamada.

payload
string

Seus dados personalizados. O valor do parâmetro será retornado na declaração payload do JWT do usuário. Recomenda-se um comprimento máximo inferior a 500 caracteres. Observe que esse parâmetro só estará disponível se você usar um armazenamento de dados de usuário personalizado.

publisher_project_id
integer

ID do projeto da Conta de Distribuidor para a qual você faz uma solicitação.

Se você especificá-lo, mas não especificar o parâmetro project_id, o serviço será encontrado vinculado ao seu project_id. Entre em contato com seu Gerente de Sucesso do Cliente para criar um link project_id para publisher_project_id.

with_logout
string
Default: "0"

Mostra se os valores JWT do usuário existentes devem ser desativados e ativa o valor gerado por essa chamada. Pode ter os seguintes valores:

  • '1' para desativar os valores existentes e ativar um novo,
  • '0' para manter os valores existentes ativados.
Request Body schema: application/json
server_custom_id
required
string <= 256 characters

ID personalizado que já existe no servidor. Observação: não é o mesmo ID que o ID de usuário do Xsolla Login.

Array of objects

Atributos de usuário que são atualizados ou criados na autenticação authduring.

Array
key
required
string <= 256 characters [A-Za-z0-9_]+

Nome do atributo utilizado para identificar o atributo do usuário. Deve ser exclusivo para cada usuário.

value
required
any
attr_type
required
string

Definição do nível de acesso do usuário aos atributos de serviço:

  • client - Um atributo editável pelo usuário. Os valores para esse tipo de atributos são inseridos por um usuário ou especificados de acordo com as lógicas do jogo no lado do cliente. Por exemplo, o nome e estatísticas do personagem, nível de dificuldade do jogo, etc.
  • server - Um atributo somente de leitura. Os valores para esse tipo de atributo são inseridos e editados no lado do servidor do seu aplicativo. Recomendamos que você os use para configurar estatísticas de personagens do jogo ou parâmetros de usuário que não devem ser alterados regularmente. Por exemplo, chance de obter um bônus, parâmetros-chave de personagens do jogo, categorias de usuário, etc.
Enum: "client" "server"
permission
required
string

Definição do nível de acesso do usuário aos atributos de outros usuários.

Enum: "private" "public"
read_only
boolean
object

Perfil social do usuário.

user_id
required
string

ID de usuário de um provedor social.

platform
required
string

Nome do provedor social.

object

User profile. This fields describe the user data.

nickname
required
string <= 255 characters

A value of field will be added to the user token. Nickname is not unique in login project. Can be added or updated during sign up or sign in.

Responses
200

OK

400

Pedido incorreto

401

Desautorizado

404

Não encontrado

422

Entidade não processável

429

Pedidos demais

Request samples
application/json
{
  • "attributes": [
    ],
  • "server_custom_id": "1234567890asdfghjkl",
  • "social_profile": {
    },
  • "user_profile": {
    }
}
Response samples
application/json
{
  • "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IiIsImV4cCI6MTY1MzEyMzk5MCwiZ3JvdXBzIjpbXSwiaWF0IjoxNjUzMDM3NTkwLCJpc3MiOiJodHRwczovL2xvZ2luLnhzb2xsYS5jb20iLCJwdWJsaXNoZXJfaWQiOjMsInNlcnZlcl9jdXN0b21faWQiOiJteS1jdXN0b20taWQtbm90LWxpbmtlZCIsInN1YiI6IjI0MTBkNmMzLWFhZDEtNGY0OS04ODNlLTQ2Y2FkM2ZiMmJjMiIsInR5cGUiOiJzZXJ2ZXJfY3VzdG9tX2lkIiwidXNlcm5hbWUiOm51bGwsInhzb2xsYV9sb2dpbl9hY2Nlc3Nfa2V5IjoiSFhzTVZSWmRtd2tuZXNZMG1pNEpUMVhJUm43bVM4ZU5oc1FxaTU4bmtCayIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiMTM3NTkyM2ItODdmMy00YTIwLWFjMmItZDBhMjg3MzBlNDIwIn0.D8dFMN5Bmgnpejq1EhZUZQP_D5iFhpO_RXnVyE03qUI"
}