Launch Games with Authenticated Player Session URLs

Use the /userAuth platform API to generate a signed game launch URL for any player, then redirect the player’s browser to start their session instantly.

To launch a game for a player, you call the GitSlotPark /userAuth endpoint with the player’s ID and the game you want to open. GitSlotPark returns an authenticated gameURL that is valid for that player’s session. You then redirect the player’s browser — or load the URL in an iframe — to start the game.

gameID values come from the /gameList API response. Fetch the game list first to get the IDs for all games available to your players. See the game list API reference.

Request

Send a POST request to /userAuth on the GitSlotPark API base URL.

Sign formula: agentID + userID + gameID

Request

{
  "apiToken": "your-api-token",
  "agentID": "Partner01",
  "userID": "player_456",
  "gameID": "game_001",
  "language": "en",
  "sign": "<hmac-sha256>"
}

Supported languages

Pass one of the following language codes in the language field to set the game interface language for the player.

Language	Code
English	en
French	fr
German	de
Italian	it
Korean	kr
Turkish	tr
Portuguese	pt
Indonesian	id
Spanish	es
Chinese	zh
Ukrainian	uk
Russian	ru

Redirect the player

Once you receive a successful response (result code 0), send the player to the gameURL:

• New tab — open gameURL in a new browser tab for a full-page experience
• Iframe — embed the URL in an <iframe> on your page to keep players within your platform UI
• Same window — redirect the current page to gameURL if your UX calls for it

Launching games in a new tab or a full-screen iframe tends to give players the best experience. Check the game provider’s requirements — some games are not designed for small iframe viewports.

Error handling

If the response contains a non-zero result code, do not redirect the player. Common errors:

Code	Meaning	Action
2	Wrong input	Check that all required fields are present and correctly formatted
3	Invalid sign	Verify your HMAC-SHA-256 computation and secret key
4	Invalid agent	Confirm your agentID with GitSlotPark
5	User not found	Verify the userID exists and is registered
7	Invalid API token	Check your apiToken value

User auth API reference

View the complete request and response schema for the /userAuth endpoint.