Return game data for Incompleted Gameplays

🎮 Description

Command 23 – Return Game Data for Incomplete Gameplays

This endpoint returns the gameid and gameplayid of the oldest incomplete game session for a given user. The oldest incomplete game must be opened and completed, before other games can be launched by this user.

Use this to detect and resume interrupted sessions, ensuring proper game flow and fairness within your application.

📜 Sample JSON Request (from your server to the RGS-CWS server)

{ "command": "23", "login": "demoaccount" }

🔐 Note: Field names and values are case-sensitive.

📥 Input Parameters (from your server to the RGS-CWS server)

Parameter	Mandatory	Description	Type
`*command`	✅	Must be `"23"`	string
`*login`	✅	Username (min. 6 characters). Required unless `userid` is used.	string
`userid`	❌	RGS-CWS user ID. Cannot be used together with `login`. You must provide either `login` or `userid`.	string

📃 Sample JSON Responses (from RGS-CWS to your server)

✅ Success – Incomplete gameplay found:

{ "message": "OK", "gameid": 857, "gameplayid": 441215 }

✅ Success – No incomplete gameplay found:

{ "message": "OK", "gameid": 0, "gameplayid": 0 }

❌ Failure – Invalid user:

{ "message": "ERROR" }

📤 Output Parameters

Parameter	Required	Description	Type
`message`	✅	`"OK"` or `"ERROR"`	string
`gameid`	✅	Game ID with the oldest incomplete gameplay. Returns `0` if none.	int
`gameplayid`	✅	Gameplay ID of the incomplete session. Returns `0` if none.	int

✅ Operator Notes

This function is used to enforce completion of unfinished sessions before allowing new games.
A user cannot start a new game if a previous game has a recorded session marked as incomplete, therefore this command solves the problem
You can redirect the player to resume the game using the returned gameid and gameplayid.
Incomplete sessions are most often the result of abrupt disconnects during bonus rounds or freespins.
Use this check during your game launcher logic to auto-resume incomplete sessions when needed.