Skip to main content
Get Player Session
curl --request GET \
  --url https://ss.game-services.work/session \
  --header 'Authorization: Bearer <token>'
GET /session?playerToken=123e4567-e89b-12d3-a456-426614174000&gameUuid=game-uuid-456

Documentation Index

Fetch the complete documentation index at: https://docs.game-services.work/llms.txt

Use this file to discover all available pages before exploring further.

GET /session

​
Headers

NameTypeDescription
X-Auth-TokenstringCustom authentication header in the format X-Auth-Token: your_token_here. This token is required to authorize API requests.

​
Request Parameters

NameTypeDescription
playerTokenstringUnique token representing the player that was received with launch url.
gameUuidstringUnique identifier of the game for which the request is being made.

​
Response Parameters

NameTypeDescription
playerIdstringUnique identifier of the player.
sessionIdstringUnique identifier of the player’s session.
currencystringThe currency code associated with the player’s session, typically in ISO 4217 format.

​
Error

If an error occurs while processing a request, the API must return a response with HTTP Status Code: 400 Bad Request
NameTypeDescription
error_codestringError code describing the specific issue.
Responsibility of the wallet platform
Assert that the incoming playerToken is valid, and return the playerID that is connected to the playerToken. The playerID that is returned must be unique per player, and identical each time an individual player authenticates. RGS will use the returned sessionId value in all subsequent Get Balance, Credit, Debit and Rollback requests for this game session. 
GET /session?playerToken=123e4567-e89b-12d3-a456-426614174000&gameUuid=game-uuid-456