Session Manager API

Session Manager API - Operator API

Validates an active player session and verifies its authenticity.

post

Validates session existence, expiration, and updates last activity timestamp.

Required headers: X-Player-Token

Sample request:

{
    "playerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Sample response:

{
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "valid",
    "expiresAt": "2025-10-08T14:00:00Z"
}
Authorizations
AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Query parameters
api-versionstringOptional
Header parameters
X-Transaction-Idstring · uuidOptional

Unique transaction identifier for request tracking

Example: 97df7c31-9d90-47da-a198-d0380f223156
X-Player-TokenstringOptional

Player access token for session validation

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Body
playerIdstring · uuidOptional
sessionIdstring · uuidOptional
Responses
200

Session validation completed successfully. Check the 'status' field to determine if the session is valid.

post
/session/validate

Retrieves all active gaming sessions for a specific player.

get

Returns active sessions (status 'Active' and not expired) for the specified player.

Required headers: X-Player-Token

Sample response:

[
  {
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "createdAt": "2025-10-08T10:00:00Z",
    "expiresAt": "2025-10-08T14:00:00Z",
    "status": "Active",
    "gameId": "550e8400-e29b-41d4-a716-446655440000"
  }
]
Authorizations
AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player whose active sessions to retrieve.

Query parameters
api-versionstringOptional
Header parameters
X-Player-TokenstringOptional

Player access token for session validation

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Responses
200

Successfully retrieved active sessions. May return empty array if no active sessions exist.

get
/session/player/{playerId}/active-sessions

Retrieves player sessions that were active during a specified date and time.

get

Performs historical session lookup for sessions active at a specific time. A session is considered active if the activity date falls between creation and expiration time.

Use cases: audit trails, compliance reporting, historical analysis. Authentication: Anonymous access allowed for administrative purposes.

Sample request:

GET /session/player/3fa85f64-5717-4562-b3fc-2c963f66afa6/by-activity?activityDate=2025-10-08T10:00:00Z

Sample response:

[
  {
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "createdAt": "2025-10-08T09:30:00Z",
    "expiresAt": "2025-10-08T13:30:00Z",
    "status": "Expired"
  }
]
Authorizations
AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Path parameters
playerIdstring · uuidRequired

The unique identifier of the player to search sessions for.

Query parameters
activityDatestring · date-timeOptional

The specific date and time (ISO 8601 format) to check for active sessions. Must be a valid DateTimeOffset value.

api-versionstringOptional
Responses
200

Successfully found sessions that were active during the specified time period.

get
/session/player/{playerId}/by-activity

Permanently revokes an active player session.

delete

Immediately terminates a player session by setting status to 'Revoked'. Once revoked, the session cannot be reactivated.

Required headers: X-Player-Token

Sample request:

{
    "playerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Sample response:

{
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "revoked"
}
Authorizations
AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Query parameters
api-versionstringOptional
Header parameters
X-Transaction-Idstring · uuidOptional

Unique transaction identifier for request tracking

Example: 66680177-6641-4eed-a299-5676d52e55eb
X-Player-TokenstringOptional

Player access token for session validation

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Body
playerIdstring · uuidOptional
sessionIdstring · uuidOptional
Responses
200

Session successfully revoked and is no longer valid for authentication.

delete
/session/revoke

Last updated