TERES API

Download OpenAPI specification:

Globus Support: soft-support@elsyton.com License: Copyright TCS Globus

Dedicated RESTfull endpoints for mobile and frontend clients

Updated: 2025-08-21 09:41:53

Find out documentation for users.

Targets for controllers

authentication-controller - Authentication in system

gas-station-controller - Gas stations and work with it

teres-rfid-card-controller - Work with RFID cards for Teres

teres-report-controller

rfid-card-user-actions-protocol-controller

authentication-controller

Login

query Parameters

interfaceLanguage	string Enum: "ua" "ru" "en"
username required	string
password required	string

Responses

Response samples

200

Content type

application/json

{"accountType": "string",
"blocked": true,
"impersonation": true,
"message": "string",
"lastUpdateRead": true,
"belongsTo": "string",
"profileDto": {"id": 0,
"timeZone": {"rules": {"fixedOffset": true,
"transitions": [{"offsetBefore": {"totalSeconds": 0,
"id": "string"
},
"offsetAfter": {"totalSeconds": 0,
"id": "string"
},
"duration": {"seconds": 0,
"units": [{"durationEstimated": true,
"dateBased": true,
"timeBased": true
}
],
"zero": true,
"negative": true,
"nano": 0
},
"gap": true,
"dateTimeBefore": "2019-08-24T14:15:22Z",
"dateTimeAfter": "2019-08-24T14:15:22Z",
"overlap": true,
"instant": "2019-08-24T14:15:22Z"
}
],
"transitionRules": [{"month": "JANUARY",
"timeDefinition": "UTC",
"standardOffset": {"totalSeconds": 0,
"id": "string"
},
"offsetBefore": {"totalSeconds": 0,
"id": "string"
},
"offsetAfter": {"totalSeconds": 0,
"id": "string"
},
"dayOfWeek": "MONDAY",
"dayOfMonthIndicator": 0,
"localTime": {"hour": 0,
"minute": 0,
"second": 0,
"nano": 0
},
"midnightEndOfDay": true
}
]
},
"id": "string"
},
"creationDate": "2019-08-24T14:15:22Z",
"ownerLogin": "string",
"userName": "string",
"avatar": "string",
"geteMail": "string",
"phoneNumber": "string",
"isNotifySound": true,
"frontSettings": "string",
"interfaceLanguage": "ua",
"geteMailNotificationSettingsDto": {"id": 0,
"isReceiveNotificationsOnEmail": true,
"noSignalInSecurity": true,
"notifyStartTask": true,
"notifyEndTask": true,
"notifyRouteDeviation": true,
"notifyTaskArriveScheduleDeviation": true,
"notifyTaskDepartureScheduleDeviation": true,
"notifyTaskPresentTimeScheduleDeviation": true,
"lockedAlarmTrigger": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyMileageCounter": true,
"isNotifyWorkingDaysCounter": true,
"isNotifyMotoHoursCanCounter": true,
"isNotifyEngineHoursCounter": true,
"isNotifyLogicalInputEngineHoursCounter": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyOutOfDayLimit": true,
"isNotifyFlowMeterFuelDrains": true,
"isNotifyRefill": true
},
"smsNotificationSettingsDto": {"id": 0,
"isReceiveNotificationsOnSms": true,
"noSignalInSecurity": true,
"lockedAlarmTrigger": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyFlowMeterFuelDrains": true
},
"insideSystemNotificationSettingsDto": {"id": 0,
"noSignalInSecurity": true,
"notifyStartTask": true,
"notifyEndTask": true,
"notifyRouteDeviation": true,
"notifyTaskArriveScheduleDeviation": true,
"notifyTaskDepartureScheduleDeviation": true,
"notifyTaskPresentTimeScheduleDeviation": true,
"lockedAlarmTrigger": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyMileageCounter": true,
"isNotifyWorkingDaysCounter": true,
"isNotifyMotoHoursCanCounter": true,
"isNotifyEngineHoursCounter": true,
"isNotifyLogicalInputEngineHoursCounter": true,
"isNotifyParkingWithEngineRunning": true,
"isNotifyOverSpeed": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyOutOfDayLimit": true,
"isNotifyFlowMeterFuelDrains": true,
"isNotifyRefill": true
},
"telegramNotificationSettingsDto": {"id": 0,
"noSignalInSecurity": true,
"notifyStartTask": true,
"notifyEndTask": true,
"notifyRouteDeviation": true,
"notifyTaskArriveScheduleDeviation": true,
"notifyTaskDepartureScheduleDeviation": true,
"notifyTaskPresentTimeScheduleDeviation": true,
"lockedAlarmTrigger": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isReceiveNotificationsOnTelegram": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyMileageCounter": true,
"isNotifyWorkingDaysCounter": true,
"isNotifyMotoHoursCanCounter": true,
"isNotifyEngineHoursCounter": true,
"isNotifyLogicalInputEngineHoursCounter": true,
"isNotifyParkingWithEngineRunning": true,
"isNotifyOverSpeed": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyOutOfDayLimit": true,
"isNotifyFlowMeterFuelDrains": true,
"isNotifyRefill": true
},
"mobileNotificationSettingsDto": {"id": 0,
"noSignalInSecurity": true,
"notifyStartTask": true,
"notifyEndTask": true,
"notifyRouteDeviation": true,
"notifyTaskArriveScheduleDeviation": true,
"notifyTaskDepartureScheduleDeviation": true,
"notifyTaskPresentTimeScheduleDeviation": true,
"lockedAlarmTrigger": true,
"receiveNotificationsOnMobile": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyMileageCounter": true,
"isNotifyWorkingDaysCounter": true,
"isNotifyMotoHoursCanCounter": true,
"isNotifyEngineHoursCounter": true,
"isNotifyParkingWithEngineRunning": true,
"isNotifyOverSpeed": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyOutOfDayLimit": true,
"isNotifyFlowMeterFuelDrains": true,
"isNotifyRefill": true
},
"mailNotificationSettingsDto": {"id": 0,
"isReceiveNotificationsOnEmail": true,
"noSignalInSecurity": true,
"notifyStartTask": true,
"notifyEndTask": true,
"notifyRouteDeviation": true,
"notifyTaskArriveScheduleDeviation": true,
"notifyTaskDepartureScheduleDeviation": true,
"notifyTaskPresentTimeScheduleDeviation": true,
"lockedAlarmTrigger": true,
"notifySensorControl": true,
"notifyDeviceInControl": true,
"isNotifyNoSignal": true,
"isNotifyFuelDrains": true,
"isNotifySosSignal": true,
"isNotifyMileageCounter": true,
"isNotifyWorkingDaysCounter": true,
"isNotifyMotoHoursCanCounter": true,
"isNotifyEngineHoursCounter": true,
"isNotifyLogicalInputEngineHoursCounter": true,
"isNotifyEntryZone": true,
"isNotifyExitZone": true,
"isNotifyOutOfDayLimit": true,
"isNotifyFlowMeterFuelDrains": true,
"isNotifyRefill": true
}
},
"login": "string",
"kind": "string",
"capabilities": {"property1": true,
"property2": true
},
"show_hints": true
}

Logout

header Parameters

Authorization

required

string

Responses

Full logout

Responses

Get current username

Responses

Response samples

200

Content type

application/json

"string"

Check token for expiration

query Parameters

token

required

string

Responses

gas-station-controller

Get gas stations by owner login

query Parameters

owner

required

string

Responses

Response samples

200

Content type

application/json

[{"type": "VEHICLE",
"name": "string",
"owner": "string",
"licensePlate": "string",
"groups": [{"id": 0,
"name": "string"
}
],
"description": "string",
"period1": 0,
"period2": 0,
"minimalPeriod1": 0,
"minimalPeriod2": 0,
"returnMinimalPeriod": true,
"currentDeviceMapping": {"deviceSettingsDto": {"id": 0,
"alarm": true,
"alarmTimestamp": "2019-08-24T14:15:22Z",
"lockedAlarm": true,
"alwaysIgnitionOn": true,
"deviceOn": true,
"outValsDto": {"firstOutVal": true,
"secondOutVal": true,
"thirdOutVal": true,
"fourthOutVal": true,
"fifthOutVal": true,
"sixthOutVal": true,
"seventhOutVal": true,
"eighthOutVal": true,
"allValsFalse": true
},
"notifyNoSignal": true,
"deviceSerial": 0
},
"deviceSerial": 0,
"from": "2019-08-24T14:15:22Z",
"to": "2019-08-24T14:15:22Z",
"id": 0
},
"tankVolume": 0.1,
"tankVolumeStart": 0.1,
"syncRemainders": true,
"rfidCardIds": [0
],
"lastKnownTime": "2019-08-24T14:15:22Z",
"idSerial": 0,
"width": 0.1,
"trailerType": "AGRICULTURAL",
"obtainFuelConsumptionByDut": true,
"enableLightInterface": true,
"vehicleId": 0,
"settings": [{"name": "string",
"unit": "string",
"value": "string"
}
],
"vehicleCounters": [{"id": 0,
"counterName": "string",
"counterType": "MILEAGE_COUNTER",
"counterTime": "2019-08-24T14:15:22Z",
"lastUpdateTime": "2019-08-24T14:15:22Z",
"counterState": true,
"startFrom": 0.1,
"triggerAfter": 0.1,
"counter": 0.1,
"endLeft": 0.1,
"logicalInputNumber": 0
}
],
"vehicleSensorControlDtoList": [{"id": 0,
"vehicleId": 0,
"sensorType": "REAL_SENSOR",
"timestamp": "2019-08-24T14:15:22Z",
"triggerName": "string",
"sensorNum": 0,
"sensorName": "string",
"condition": "string",
"thresholdValue": 0.1,
"text": "string",
"active": true
}
],
"vehicleDeviceInControls": [{"id": 0,
"vehicleId": 0,
"triggerName": "string",
"timestamp": "2019-08-24T14:15:22Z",
"inputNumber": "string",
"status": true,
"text": "string",
"active": true
}
],
"virtualSensors": [{"title": "string",
"fracDigits": 0,
"units": "string",
"vehicleId": 1,
"increasing": true,
"visible": true,
"virtualSensorId": 0,
"sensorType": "isFuelLevel"
}
],
"multiSensors": [{"aggregate": "string",
"title": "string",
"realSensorSocketIds": [0
],
"virtualSensorId": 0,
"id": 0,
"realSensorSockets": [{"id": 0,
"name": "string",
"virtualSensorId": 0,
"vehicleId": 0,
"realSensors": [{"realSensorId": 0,
"sensorNumber": 0,
"position": 0,
"vehicleToDeviceMappingId": 1,
"vehicleId": 1,
"reverse": true,
"realSensorSocketId": 0,
"from": "2019-08-24T14:15:22Z",
"to": "2019-08-24T14:15:22Z",
"virtualSensorId": 0,
"fromZero": true,
"current": true
}
],
"sensorCalibrationMappings": [{"id": 0,
"sensorCalibrationId": 0,
"sensorCalibrationName": "string",
"from": "2019-08-24T14:15:22Z",
"to": "2019-08-24T14:15:22Z",
"current": true
}
]
}
]
}
],
"realSensorSockets": [{"id": 0,
"name": "string",
"virtualSensorId": 0,
"vehicleId": 0,
"realSensors": [{"realSensorId": 0,
"sensorNumber": 0,
"position": 0,
"vehicleToDeviceMappingId": 1,
"vehicleId": 1,
"reverse": true,
"realSensorSocketId": 0,
"from": "2019-08-24T14:15:22Z",
"to": "2019-08-24T14:15:22Z",
"virtualSensorId": 0,
"fromZero": true,
"current": true
}
],
"sensorCalibrationMappings": [{"id": 0,
"sensorCalibrationId": 0,
"sensorCalibrationName": "string",
"from": "2019-08-24T14:15:22Z",
"to": "2019-08-24T14:15:22Z",
"current": true
}
]
}
],
"lockStateDto": {"deviceId": 0,
"lockStateTime": "2019-08-24T14:15:22Z",
"lockState": true,
"name": "string"
}
}
]

notification-controller

Get all unread notifications by owner login

path Parameters

ownerLogin

required

string

query Parameters

index	integer <int32>
descriptions	Array of strings

Responses

Response samples

200

Content type

application/json

[{"id": 0,
"timestamp": "2019-08-24T14:15:22Z",
"vehicleId": 0,
"licensePlate": "string",
"vehicleName": "string",
"owner": "string",
"description": "string",
"notificationType": "emergency",
"notificationText": "string",
"readStatus": true,
"deviceId": 0
}
]

teres-report-controller

Create reports as json

path Parameters

gasStationId

required

integer <int64>

query Parameters

locale required	string Enum: "UA" "UK_UA" "UK" "RU_UA" "EN" "RU" "RU_RU"
required	object

Responses

Response samples

200

Content type

application/json

[{"reportDto": {"reportName": "string",
"report_table": [{"rows": [{"cells": [{"values": [null
]
}
]
}
],
"reportTableName": "string"
}
]
},
"graphicsDtos": [{"name": "string",
"diagramDtoList": [{"name": "string",
"value": "string",
"color": "string"
}
]
}
]
}
]

teres-rfid-card-controller

getRfidCardsByOwner

path Parameters

login

required

string