ИнтеграцияИнтеграция по APIРабота с терминалами

Работа с терминалами

Получение информации о терминале

Общее описание

Функция GET /v6/api/terminalManagement/terminal позволяет получить инфорацию о терминале.

Параметры вызова

В запросе используется обязательный параметр terminalPhysicalID — физический идентификатор терминала.

Результат выполнения

Функция возвращает массив структур со следующими параметрами:

Параметр Описание
terminalPhysicalID Физический ИД терминала
lastLocationDate Дата последней локации
isValidLastLocation Валидность локации. Существуют следующие значения:
  • true – локация является валидной;
  • false – локация не является валидной.
lastLocationReceiveDate Дата получения последней локации
Параметры датчиков устройства (массив структур sensors)
sensorValue Значение датчика
sensorValueDateTime Время значения датчика
name Название датчика

Формат запроса

GET /v6/api/terminalManagement/terminal?terminalPhysicalID=string HTTP/1.1
Host: host		
Authorization: Bearer token

Пример запроса

GET /v6/api/terminalManagement/terminal?terminalPhysicalID=aabgfaaabmcgofealmdmkdiolhafgdff HTTP/1.1
Host: api.mpoisk.ru
Authorization: Bearer token

Формат ответа

\{
  "terminalPhysicalID": "string",
  "lastLocationDate": "string",
  "isValidLastLocation": boolean,
  "lastLocationReceiveDate": "string",
  "sensors": [
    \{
      "sensorValue": "string",
      "sensorValueDateTime": "string",
      "name": "string"
    }
  ]
}

Пример ответа

\{
  "terminalPhysicalID": "aabgfaaabmcgofealmdmkdiolhafgdff",
  "lastLocationDate": "2025-02-11T13:08:37.545Z",
  "isValidLastLocation": true,
  "lastLocationReceiveDate": "2025-02-11T13:08:37.545Z",
  "sensors": [
    \{
      "sensorValue": "55",
      "sensorValueDateTime": "2025-02-11T13:08:37.545Z",
      "name": "Топливо"
    }
  ]
}