listOrphans

Retrieves a list of all reporting Vista "Devices" (aka "Stations") that are not currently associated with any "Site"

End-Point is located at: https://devices.vantage.co/api/listOrphans.php
Parameters are provided to the end-point as POST data in JSON format
Results are returned in JSON format

Parameters TO end-point:

  apikey              the 32-character API Key (validates the end-point user)

Results FROM end-point:

  Result              either "OK" or "FAIL"

  ResultCode          0 = Success ('Result' = "OK")
                      1 = apikey was not provided
                      2 = apikey was not valid
                      3 = apikey has expired

  Message             Human-readable explaination of ResultCode
                      Appropriate for display to user FOR ResultCode values other than 0

Upon a ResultCode of 0 (success), the following JSON data will also be present:

  station_count       Number of "station" objects returned
  stations[]          Array of "station" objects

Each "station" object contains:

  primary_mac         The ID of this site (used in other calls that require the specific site to be specified)
  description         Human-readable description of the device
  station_type        The "type" of device (the station/device hardware)
  age                 Integer number of seconds since the last heartbeat was seen from this device
  eth0_mac            The MAC address of the first Ethernet port - or 00:00:00:00:00:00 if ethernet port not installed
  eth1_mac            The MAC address of the second Ethernet port - or 00:00:00:00:00:00 if ethernet port not installed
  wlan0_mac           The MAC address of the first Wireless LAN port - or 00:00:00:00:00:00 if ethernet port not installed
  eth0_address        The current IP address of the first Ethernet port - or 0.0.0.0 if no address set
  eth1_address        The current IP address of the second Ethernet port - or 0.0.0.0 if no address set
  wlan0_address       The current IP address of the Wireless LAN port - or 0.0.0.0 if no address set
  assigned_server     The server (for heartbeats and management) assigned to this device
  reported_server     The server (for heartbeats and management) this device is currently using
  baseurl             The Full URL of the web-application assigned to this device.
  temperature_c       The last-reported internal temperature of the device - as a string - ie: "39.2"
  status              Either "ONLINE" or "OFFLINE" - based on an 'age' reported < or > than 650 seconds
  port_count          Number of "port" objects returned for this device
  ports[]             Array of "port" objects associated with this device

Each "port" object contains:

  remote_port         The port # on the server that is mapped to the device's port
  local_port          The port # on the device that is mapped to the server's port