Site_Administration_APIs

Site Administration APIs

All requests to the Site Administration APIs must be made from a partner managed account type. ENGAGE managed login types cannot access these APIs.

The Site Administration APIs include the following:

TermDefinitions
ENGAGE Managed- If the site access management uses ENGAGE. It is common for an externally managed site, that this is false.
Role- Operator
- Manage
- SiteAdmin
Site Name- The 32-byte Site Key encryption key. The value is a hexadecimal value that is encoded in Base64 format.
NOTE: The value should be Base64 encoded starting as a hexadecimal string of characters, not an ASCII representation of a hexadecimal string.
Default Host Address- A URL to change the site's default hostname location. Value must be a valid URL including http or https.
- Only valid when IsEngageManaged == FALSE.
- This is an optional feature of site creation that is intended to reduce occurrences of manual errors created during commissioning of devices.
- It makes client connection (e.g. WiFi) requests to a partner managed server for database updates and audit posting.
Site Software Key- This string should be identical to the "Value" string provided by GET /engage/lookupsitesoftware.
Site Reference- The reference ID of site the invite is assigned to.
Operator ID- OperatorId is a unique 64 bit integer value on a per site basis. The same user has a different OperatorId for each site they are an "Operator", "Manager", or "SiteAdmin".