Terminal - Get terminal status

API Url

Use it to return every terminal status

GET
http://localhost:16010/ProMarkRESTweb/Terminal/terminals

Permissions: user

Request headers

FieldTypeDescription
Accept-LanguageoptionalString

=en-GB Language use for localization.

X-ClientoptionalString

=Client type.

Allowed values:"Portal""Mobile""Admin"
X-RoleoptionalNumber

ProMark role (1: Employee, 2: User).

Allowed values:{12}
X-WebPart-IdoptionalNumber

Unique web-part identifier.

Query parameters

FieldTypeDescription
nameoptionalString

Name of terminal controller job. Records are filtered using this field.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    terminalsObject[]
      biosString

Terminal bios version

      controllerString

The name of the terminal controller job

      descriptionString

Terminal description

      firmwareString

Terminal firmware

      idNumber

The id of the terminal

      ipString

Terminal ip

      macString

Terminal mac

      pendingBootBoolean

Terminal requires restarting

      serialString

Terminal serial no.

      statusNumber

The status of the terminal. 0 Inactive 1 Loadfile missing 2 Loading 3 Active 5 Stopped by MNC2 due to an error in Hook In 8 Conflict 9 No connection to MNC2

      typeNumber

The type of the terminal

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"terminals": [
{
"id": 2,
"type": 7,
"controller": "Kaba",
"status": 0,
"pendingBoot": true,
"description": "Mark Terminal",
"ip": "192.168.18.5",
"firmware": "4.00",
"bios": "1",
"mac": "02-CD-08-08-00-16",
"serial": "31415-02-0808-0022"
},
{
"id": 11,
"type": 7,
"controller": "Kaba",
"status": 0,
"pendingBoot": true,
"description": "LAN Test JAO",
"ip": "192.168.18.143",
"firmware": "4.11",
"bios": "1",
"mac": "02-CD-08-0A-01-17",
"serial": "31415-02-0810-0123"
}
]
}
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.