APIs & services / Reporting datasets (rtld)

Cadre login history.

Endpointtoday's app

Call: GET /rtld/api/dataset/v1/execute?name=PlusOneCadreLoginHistory
Service: Reporting datasets (rtld)
Features: Login history
When: User opens login history
Auth: X-SESSIONID header (AuthInterceptor adds it; re-auth on 401/400)
In the App Service: GET /me/login-history

Use case

Runs when the user opens Login History (LoginHistoryFragment -> LoginHistoryViewModel -> LoginHistoryRepositoryImp.fetchLoginHistory). The rows are saved as JSON in SharedPreferences KEY_LOGIN_HISTORY and listed from there, showing each login date and the number of devices. Offline or failed calls show "no internet" or "Something went wrong" and the last cached list.

Headers

Header	Value	Notes
`X-SESSIONID`	<session token>	Passed explicitly as @Header from AndroidSessionManager.sessionId. AuthInterceptor still retries once with a fresh token on 401 or 400.

Parameters

Param	In	Required	Example	Notes
`name`	query	Yes	`PlusOneCadreLoginHistory`	Hard-coded in the @GET path with version and format.
`version`	query	Yes	`1`	Dataset version. Always 1.
`format`	query	Yes	`json`	Response format. Always json, so the body is a JSON array of row objects.
`params`	query	Yes	`CADRE_LOGIN=9XXXXXXXX1@@tenant.example`	Dataset input parameters as KEY=value pairs joined with "--". CADRE_LOGIN = AndroidSessionManager.userId as-is (here the full user id is sent, not trimmed at "@@").

Request

No body. cadre params

Response

Example response body (synthetic data)

[
  {
    "loginName": "9XXXXXXXX1",
    "attemptedDate": "2026-10-20",
    "different_devices": 1
  },
  {
    "loginName": "9XXXXXXXX1",
    "attemptedDate": "2026-10-21",
    "different_devices": 2
  }
]

Field	Type	Notes
`loginName`	string	Login shown in the row.
`attemptedDate`	string	Login date shown in the row.
`different_devices`	int	Number of devices used that day (LoginHistoryDTO.differentDevices).

Errors

Status	When	What the app does
`401 / 400`	Session token expired or rejected	AuthInterceptor refreshes the token and retries once; if the retry also fails, Resource.error "Something went wrong"; the cached list is shown.
`5xx`	Dataset query failed on the server	Resource.error "Something went wrong"; the cached list is shown.
`network error`	No connectivity or timeout	Resource.error "Something went wrong"; the cached list is shown.

Source

app/src/main/java/org/platformcommons/urvi/datasource/network/retrofit/APIInterface.kt
app/src/main/java/org/platformcommons/urvi/datasource/repository/impl/LoginHistoryRepositoryImp.kt
app/src/main/java/org/platformcommons/urvi/view/login_history/LoginHistoryFragment.kt
app/src/main/java/org/platformcommons/urvi/datasource/network/responsedto/LoginHistoryDTO.kt