Autenticação por ID personalizado

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

User nickname. The value will be added to the nickname field in the user JWT. Can't be empty. Spaces are allowed, but will be trimmed before and after the nickname. Can be non-unique. You can change the user's nickname value in the Xsolla system using the same method.

Responses

200

400

Pedido incorreto

401

Desautorizado

404

Não encontrado

422

Entidade não processável

429

Pedidos demais

Request samples

application/json

{"attributes": [{"attr_type": "server",
"key": "company",
"permission": "private",
"value": "facebook-promo"
},
{"attr_type": "server",
"key": "custom-id",
"permission": "private",
"value": 48582
}
],
"server_custom_id": "1234567890asdfghjkl",
"social_profile": {"platform": "xbox",
"user_id": 4352354
},
"user_profile": {"nickname": "John_Doe_1337"
}
}

Response samples

application/json

{"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6IiIsImV4cCI6MTY1MzEyMzk5MCwiZ3JvdXBzIjpbXSwiaWF0IjoxNjUzMDM3NTkwLCJpc3MiOiJodHRwczovL2xvZ2luLnhzb2xsYS5jb20iLCJwdWJsaXNoZXJfaWQiOjMsInNlcnZlcl9jdXN0b21faWQiOiJteS1jdXN0b20taWQtbm90LWxpbmtlZCIsInN1YiI6IjI0MTBkNmMzLWFhZDEtNGY0OS04ODNlLTQ2Y2FkM2ZiMmJjMiIsInR5cGUiOiJzZXJ2ZXJfY3VzdG9tX2lkIiwidXNlcm5hbWUiOm51bGwsInhzb2xsYV9sb2dpbl9hY2Nlc3Nfa2V5IjoiSFhzTVZSWmRtd2tuZXNZMG1pNEpUMVhJUm43bVM4ZU5oc1FxaTU4bmtCayIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiMTM3NTkyM2ItODdmMy00YTIwLWFjMmItZDBhMjg3MzBlNDIwIn0.D8dFMN5Bmgnpejq1EhZUZQP_D5iFhpO_RXnVyE03qUI"
}