Xsolla-logo

Auth via device IDClient-side

post/login/device/{device_type}

Authenticates a user via a particular device ID. To enable silent authentication, use the instruction.

Request
path Parameters
device_type
required
string

Type of the device.

Enum: "android" "ios"
query Parameters
projectId
required
string <uuid>

Login project ID from Publisher Account.

payload
string

Your custom data. The value of the parameter will be returned in the payload claim of the user JWT. Recommended maximum length less than 500 characters. Note, that this parameter is only available if you use a custom user data storage.

with_logout
string
Default: "0"

Shows whether to deactivate the existing user JWT values and activate the one generated by this call. Can have the following values:

  • 1 to deactivate the existing values and activate a new one,
  • 0 to keep the existing values activated.
Request Body schema: application/json
device
required
string <= 100 characters

Manufacturer and model name of the device.

device_id
required
string [ 16 .. 36 ] characters

Device ID:

Responses
200

OK

400

Bad Request

401

Unauthorized

404

Not Found

422

Unprocessable Entity

429

Too Many Requests

Request samples
application/json
{
  • "device": "ONEPLUS A6003",
  • "device_id": "1AF516EFACD646F6"
}
Response samples
application/json
{
  • "token": "string"
}