Xsolla-logo

通过自定义ID进行认证

post/users/login/server_custom_id

通过特定的自定义ID对用户进行认证。如果用户不存在，则创建用户。

SecurityServer
Request
query Parameters
projectId
string <uuid>

发布商帐户中的登录管理器项目ID。如果不指定，则对指定的publisher_project_id参数使用影子登录管理器。

无需向此调用传入影子登录管理器ID。

payload
string

您的自定义数据。参数的值将在用户JWT的payload声明中返回。

publisher_project_id
integer

向其提出请求的发布商帐户中的项目ID。

如果指定了该ID，但未指定project_id参数，则会发现服务被关联到其project_id。请联系您的客户成功经理将project_id关联到publisher_project_id。

with_logout
string
Default: "0"

显示是否停用现有用户JWT值并激活此调用生成的值。可以是以下值：

  • 1，停用现有值并激活新值；
  • 0，保持现有值的激活状态。
Request Body schema: application/json
server_custom_id
required
string <= 256 characters

自定义ID由您的服务器生成（不是艾克索拉登录管理器用户ID）。它应该在密钥中。

Array of objects

可选参数。包含进行身份认证时保存的用户自定义属性

Array
key
required
string
value
required
any
attr_type
required
string
Enum: "client" "server"
permission
required
string
Enum: "public" "private"
read_only
boolean
object

需要关联到用户的社交网络个人资料。

user_id
required
string

来自社交网络提供商的用户ID。

platform
required
string

社交网络提供商的名称。

Responses
200

确定

400

错误的请求

401

未授权

404

未找到

422

无法处理的实体

429

请求过多

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