Game Sessions

Create Game Session

• Endpoint: POST /v1/game/session

• Description: Creates a playable game session for a user.

• Headers:

  • Authorization: Bearer <accessToken>
  • x-signed-request: <signature>

• Body:

  Field	Type	Required	Description
  userToken	string	Yes	Token from user auth
  gameId	string	Yes	Game ID
  balance	number	No	Override initial balance

• Success Response (201):

{
  "status": "success",
  "data": {
    "sessionId": "507f1f77bcf86cd799439099",
    "gameUrl": "https://<game-model>.play.xigsapi.com?ssid=507f1f77bcf86cd799439099",
    "expiresAt": "2025-01-02T13:30:00.000Z"
  }
}

• Errors: 400, 401, 403, 404, 500

List Game Sessions

• Endpoint: GET /v1/game/session

• Description: Lists active sessions.

• Headers: Authorization: Bearer <accessToken>

• Query Params:

  Field	Type	Required	Description
  gameId	string	No	Filter by game
  userId	string	No	Filter by user
  showRoundsAndTransactions	boolean	No	Include session details

• Success Response (200):

{
  "status": "success",
  "data": [
    {
      "sessionId": "507f1f77bcf86cd799439099",
      "gameId": "507f191e810c19729de860ea",
      "userId": "507f1f77bcf86cd799439022",
      "betWins": 0,
      "totalBets": 0,
      "createdAt": "2025-01-02T11:30:00.000Z",
      "expiresAt": "2025-01-02T13:30:00.000Z"
    }
  ]
}

• Errors: 400, 401, 500