API Reference

Devices

Device Object shows top level information about PDU power, energy, sensors, and etc. Attributes will differ depending on it's models.

Endpoints

GET    /api/device                 Returns object describing top level device information


Device Object

KeyTypeDescription
numBanksnumberNumber of banks: a section of outlets on a specific circuit
numOutletsnumberNumber of outlets total
numInletsnumberNumber of inlets. Either 1 or 2
inletPlugstringInlet Plug receptacle/plug. If multiple inlets, both are same plug type
outletPwrMeasurementsSupportedbooleanWhen true, each outlet can measure current draw in amps
outletSwitchingSupportedbooleanWhen true, each outlet can switch on or off with a relay
enclosureSerialNumberstringUnique ID for PDU Enclosure.
modelNumberstringSpecific PDU model number
inletConfigstringEither "standard", "dualcircuit", or "ats"
formFactorstringEither "0U", "1U", or "2U"
controllerSerialNumbernumberSerial Number of SynLink Controller Module
controllerFirmwareVersionstringFirmware version for controller
controllerHardwareVersionstringHardware version for controller
phasestringEither "Single Phase", "Three Phase Delta", or "Three Phase Wye"
circuitBreakerProtectionbooleanTrue if circuit breaker protection exists
uptimenumberNumber of seconds the PDU has been on.
timestringTime in ISO8601 String Format.
{
  "numBanks": 3,
  "numOutlets": 36,
  "numInlets": 1,
  "inletPlug": "L21-30P",
  "outletPwrMeasurementsSupported": true,
  "outletSwitchingSupported": true,
  "enclosureSerialNumber": 1024122712,
  "modelNumber": "SP-3001CA-HA",
  "inletConfig": "standard",
  "formFactor": "0U",
  "controllerSerialNumber": 1360604425,
  "controllerFirmwareVersion": "1.0.3",
  "phase": "Single Phase",
  "controllerHardwareVersion": "1.0.0",
  "circuitBreakerProtection": true,
  "uptime": 19284619
}


Get Device Info

Retrieve PDU device information.

GET    /api/device      Returns object describing top level device information

Example Request

curl 'http://192.168.1.100/api/device' \
--header 'Authorization: Bearer j2d36cG2ciHKDDqFc3k'

Response Body

{
  "numBanks": 3,
  "numOutlets": 36,
  "numInlets": 1,
  "inletPlug": "L21-30P",
  "outletPwrMeasurementsSupported": true,
  "outletSwitchingSupported": true,
  "enclosureSerialNumber": "1024122712",
  "modelNumber": "SP-3001CA-HA",
  "inletConfig": "standard",
  "formFactor": "0U",
  "controllerSerialNumber": "1921218731",
  "controllerFirmwareVersion": "0.1.2",
  "controllerHardwareVersion": "1.0.1",
  "circuitBreakerProtection": true,
  "uptime": 19284619
}