Find.HomeSeer.com

Usage

The find service is used on a local network to find a homeseer system. Most systems use DHCP to obtain an IP address so it's location can change. From a web browser a user can simply go to find.homeseer.com and the available systems will be listed.

Developers can use this service if they have an application that needs to connect to a HomeSeer system. To request a systems list use the url:

https://find.homeseer.com/findhomeseer/iplist.aspx?json=true

The response will be json, here is a sample output. Note that this output reports 5 systems available, but most responses will only contain 1. Ideally the developer would prompt the user with the systems list and let them pick a system. The developer can then save the name of the system using the "machine" property. The system name normally does not change.

CODE

{
   "Name":"HomeSeer Systems",
   "Version":"1.0",
   "Systems":[
      {
         "wanip":"1.2.3.4",
         "localip":"192.168.86.53",
         "machine":"HomeTrollerS",
         "port_num":80,
         "port_num_tools":911,
         "last_seen":"\/Date(1591796118559)\/",
         "licenseID":"",
         "IsSystem":true,
         "IsTools":false,
         "device":""
      },
      {
         "wanip":"1.2.3.4",
         "localip":"192.168.86.187",
         "machine":"hometrollerSEL",
         "port_num":80,
         "port_num_tools":911,
         "last_seen":"\/Date(1591796061191)\/",
         "licenseID":"",
         "IsSystem":true,
         "IsTools":true,
         "device":""
      },
      {
         "wanip":"1.2.3.4",
         "localip":"192.168.86.32",
         "machine":"HomeTrollerZeeS2V5",
         "port_num":911,
         "port_num_tools":911,
         "last_seen":"\/Date(1591795832758)\/",
         "licenseID":"",
         "IsSystem":false,
         "IsTools":true,
         "device":""
      },
      {
         "wanip":"1.2.3.4",
         "localip":"192.168.86.45",
         "machine":"HomeTrollerZeeS2V7",
         "port_num":911,
         "port_num_tools":911,
         "last_seen":"\/Date(1591795532518)\/",
         "licenseID":"",
         "IsSystem":false,
         "IsTools":true,
         "device":""
      },
      {
         "wanip":"1.2.3.4",
         "localip":"192.168.86.193",
         "machine":"HS4PiV1",
         "port_num":80,
         "port_num_tools":911,
         "last_seen":"\/Date(1591795964585)\/",
         "licenseID":"",
         "IsSystem":true,
         "IsTools":true,
         "device":""
      }
   ]
}

For finding a HomeSeer system, the important properties are:

localip: This is the IP address of the given system and can be used to access the system
port_num: This is the port number the system is listening on. While most systems will be on the default port of port 80, the user has the option of picking a different port.

Most installations will only report one system, but it is possible for a user to have more than one. Also, other HomeSeer hardware such as out Z-Net Z-Wave controller may be installed and will be included in the list. These can be filtered out by looking at the "device" property, it will be "znet" for these devices. If the "device" property is an empty string the system is a HomeSeer system.