-
Pelican Connect
-
- Tips for Evaluating Notifications in the Pelican System
- Thermostat Notification Configurations
- Thermostat Unreachable
- Understanding a “Cool Failure” Notification
- Understanding a “Heat Failure” Notification
- Understanding an “Economizer Position Failure” Notification
- Understanding the “Door or Window Has Been Left Open” Notification
- Understanding Low Battery Notifications for Pelican Devices
-
Admin
-
- Can I pay for multiple site subscriptions at once?
- Can I pay for my subscriptions using a purchase order (PO)?
- How do I change my site type (residential, business, hotel)?
- How do I pay for my site’s subscription?
- What does the Standard Subscription provide?
- What is the Subscription Renewal History?
- Why has my subscription expired?
- How do I view my LTE Gateway Subscription Receipt?
- How do I change my LTE Subscription Email Address?
- How Can I Cancel My LTE Gateway Subscription?
-
Comfort Control
-
- How do I adjust a room temperature?
- How do I turn off all thermostats for an emergency?
- How do I turn ON-OFF cooling?
- How do I turn ON-OFF heating?
- How do I turn ON-OFF the Fan? - not done
- What does Cool Running mean?
- What does Economizer Active mean?
- What does Fan Running mean?
- What does Heat Running mean?
- What does Space Satisfied mean?
- What does Waiting mean?
- Why did cooling start on its own? - not done
- Why did heating start on its own? - not done
-
- Directions on maintaining proper ventilation rates: COVID-19
- What is Outside Ventilation in a schedule?
- Does Pelican adjust an outside damper based on fan speed?
- How do I adjust the CO2 level to generate additional ventilation?
- How do I commission a PEARL for proper ventilation?
- How do I turn off ventilation for all thermostats on a poor outdoor air day?
- What are CO2 Levels?
- What do different CO2 levels indicate ?
- Does Pelican detect CO2 levels as a life safety system?
- How do I adjust my CO2 ventilation configuration?
- What is the Outside Ventilation setting?
-
-
Schedules
- Can I schedule a thermostat to a set points beyond its allowable heat or cool range? - not done
- Can I schedule when Fan Circulation Minutes is active?
- What is unoccupied setback in a thermostat schedule?
- How to set set fan to auto during unoccupied setback periods?
- How do I set an a single thermostat's schedule?
- What is Outside Ventilation in a schedule?
- What are the schedule Repeat options?
- What is optimum start?
- Why did cooling start on its own? - not done
- Why did heating start on its own? - not done
-
- How do I create an event schedule for a single thermostat?
- How do I delete an event scheduled for a single thermostat?
- How do I create an event schedule for multiple thermostats?
- How do I edit a multiple thermostat event scheduled?
- How do I delete a multiple thermostat event scheduled?
- How do I edit an event scheduled for a single thermostat?
-
- How do I create shared schedules? - not done
- How do I edit a shared schedule?
- How do I create unoccupied set point override periods?
- How do I rename a shared schedule?
- How do I copy an existing shared schedule?
- How do I delete an existing shared schedule?
- How do I create an event schedule for multiple thermostats?
- How do I edit a multiple thermostat event scheduled?
- How do I delete a multiple thermostat event scheduled?
-
Thermostat
-
- Can a Pelican thermostat control a floating actuator?
- Can a Pelican thermostat control a two-position actuator?
- Can a Pelican thermostat control a multiple fan speeds?
- Can I "lock-out" compressors based on an outdoor temperature?
- Can I disable or lock a thermostat’s Fan Button?
- Can I disable the thermostat’s internal temperature sensor?
- How do I hide a thermostat on the app?
- How does Pelican assist with freeze prevention?
- How do I control a dual fuel Heat Pump?
- How many Cool Stages do I select for a thermostat?
- How many Fan Stages do I select for a thermostat?
- How many Heat Stages do I select for a thermostat?
- What do I set Heat Needs Fan to?
- What is CO2 Ventilation?
- What is Compressor Lockout?
- What is Cool Range?
- What is Fan Circulation Minutes?
- What is Heat Range?
- What is the difference between Auxiliary and Emergency Heat?
- What should I set a thermostat’s Reversing Valve to?
- What should I set a thermostat’s System Type to?
- What should I set Anticipation Degrees to?
- What should I set Cycles Per Hour to?
- When should I use the thermostat Calibration Degrees?
- What should I set a thermostat’s Zone Controller configuration to?
- What should I set Fan Purge Cycle to?
- What should I set Damper Type to?
- What should I set Reheat Type to?
- What should I set Notification Settings to?
- How to hide a section within an article.
- How can I Delete a Thermostat from a site?
- How do I delete a Wired Temperature Sensor or PEARL Economizer Controller?
- How can I Replace a Thermostat?
- Show all articles ( 18 ) Collapse Articles
-
-
Networking
-
- How do I install a Pelican cellular gateway?
- How do I replace a Pelican Cellular gateway with a Pelican Ethernet gateway?
- Can I set a Pelican gateway for a static IP address?
- Do I need a Public IP address for a Pelican gateway?
- Does a Pelican gateway use a DHCP or static IP address?
- Does a Pelican gateway use Inbound firewall ports?
- How do I change a Pelican gateway from static back to DHCP?
- How do I install a Pelican Ethernet gateway?
-
PEARL
-
Zone Coordinator
-
- Why won’t my zone controller connect?
- What do the lights on the zone controller indicate? - not done
- What does the light on a zone controller's antenna indicate? - not done
- Why is a zone controller unreachable? - not done
- What do the zone controller lights indicate? - not done
- What do the zone controller's antenna lights indicate? - not done
- Zone Controller Dehumidify Sequences
-
- What do the lights on the zone controller indicate? - not done
- TS Thermostat Symbols
- What do the zone controller's antenna lights indicate? - not done
- What do the zone controller lights indicate? - not done
- What does the light on a zone controller's antenna indicate? - not done
- TC Thermostat Symbols
-
- How does Pelican control a parallel fan powered box during a heating cycle?
- How does Pelican control a series fan powered box during a heating cycle?
- How does Pelican control a zone box during a heating cycle?
- How does Pelican control a parallel fan powered box during a cooling cycle?
- How does Pelican control a series fan powered box during a cooling cycle?
- How does Pelican control a zone box during a cooling cycle?
- How does Pelican control a parallel fan powered box during a ventilation cycle?
- How does Pelican control a series fan powered box during a ventilation cycle?
- How does Pelican control a zone box during a ventilation cycle?
-
-
Power Control
- Articles coming soon
-
Sensors
-
OpenAPI
Categories:
OpenAPI
Introduction
Getting Started
UPDATED
The Pelican OpenAPI provides a powerful and flexible way to integrate Pelican devices into your own applications. With real-time access to device data and settings, you can extend the functionality of your Pelican Solution beyond the built-in interface, enabling advanced automation, monitoring, and system control.
What is the Pelican OpenAPI?
The Pelican OpenAPI is a RESTful API that allows you to:
- Retrieve real-time and historical data from your Pelican devices.
- Adjust device settings and operational parameters remotely.
- Integrate Pelican functionality into custom applications, dashboards, or third-party systems.
The API supports JSON and XML responses and uses standard HTTP GET and POST methods for requests. All API transactions are encrypted using SSL and require authentication for security.
Who is this for?
The Pelican OpenAPI is designed for developers who want to build custom integrations or automation solutions using their Pelican system. Whether you’re creating a simple script to pull temperature data or a full-scale application to manage multiple devices, the API provides the flexibility and security needed for seamless integration.
API Categories & Key Attributes
The Pelican OpenAPI gives you access to a wide range of data, organized into eight key categories:
Thermostat API – Control and monitor thermostat configurations, settings, and history (up to 2 years). Supports TC and TS series thermostats.
Key Objects:
Thermostat, ThermostatSchedule, SharedSchedule, Thermostat History, ThermostatEvent, ThermostatUsage
Power Control Module API – Control relay states and schedules for PM5-120/240 and PM5-277 modules.
Key Objects: PowerOutput & PowerSchedule
MySites – Retrieve information on all sites linked to a user account.
Key Objects: MySites
Users – Access and modify user profiles and notification settings.
Key Objects: User
Notification – View and manage real-time and historical alerts.
Key Objects: Notification
Sites – Retrieve site-level details from the Pelican App.
Key Objects: Site
Demand Response – Schedule and track demand response events.
Key Objects: drEvent & DemandResponseHistory
Power Usage – Access energy consumption data from Pelican PowerLink (utility unique item, Contact Pelican Sales for more information).
Key Objects: PowerUsage
Attribute Types
System-reserved attributes for standard data points.
Reserved Attributes
User Defined Attributes
Custom attributes that users can create and retrieve.
To define a new attribute, simply set its value via a SET request, then retrieve it with a GET request. User-defined attributes can also be used for filtering data.
Example Use Case: Grouping Thermostats
Want to track specific thermostats? Assign them a custom “managed: yes” attribute and filter your API calls accordingly.
Avialable PERL Software
Pelican Wireless Systems offers a Perl module designed to simplify interactions with the Pelican OpenAPI. This module serves as a convenient wrapper, providing Perl developers with an easier interface to the API. Additionally, it can be used as a reference for constructing valid requests and processing API responses.
To obtain a copy of the Perl module, please contact Pelican Technical Support.
Example Script Using the Pelican ClimateControl Perl Module:
GET
How to request an API authentication token from MySites using the Sites object to GET Name, Domaine, and Token attributes.
// request token from mysites.
#!/usr/bin/perl -w
use ClimateControl;
my $username = 'email@domain.com';
my $password = 'my-password';
my $website = 'mysites.officeclimatecontrol.net';
my $cc = new ClimateControl($username, $password, $website);
my $objectType = 'Sites';
my $selectionAttributes = {
'name' => 'my-site-name'
};
my $requestedAttributes = [
'name',
'domain',
'token',
];
my $data = $cc->getAttributes($objectType, $selectionAttributes, $requestedAttributes);
if(!$data->{success})
{
print "Failed to get the list of sites - $data->{message}";
exit 1;
}
my $list = $data->{Sites};
foreach my $site (@$list)
{
print "The token for site $site->{name} is $site->{token}\n";
Authentication
To securely access the Pelican OpenAPI, authentication is required for each request. There are two primary methods to authenticate:
1. Username and Password Authentication
Each API request must include the following parameters:
username – This is the email address of a validated Pelican App user. An administrator must add this email address within the Pelican App’s User Management section.
password – The corresponding password for the email address linked to the username. Since the Pelican API only allows SSL connections, the password is automatically encrypted for each request.
2. Token-Based Authentication via MySites
For users managing multiple Pelican sites through MySites, token-based authentication offers a streamlined approach:
Generate a Token: Authenticate with MySites using your username and password to the MySites API, requesting a token. This token can then be used to authenticate with all Pelican Apps associated with your MySites account. Tokens are valid for 24 hours.
Example MySites Token Request:
GET
How to request an API authentication token from MySites using the Sites object to GET Name, Domaine, and Token attributes.
https://mysites.officeclimatecontrol.net/api.cgi?username=Email@domain.com&password=MyPassword&request=get&object=Sites&selection=name:my-site-name&value=name;domain;token
Example Token Response:
my-site-name
my-site-name.officeclimatecontrol.net
KcRVrDu7Hd6p8YfoXqSq6oln6+nC6eSmY2q12dODy0HEQO5QHkM3dkb/N4OJpshW46JhBj+cwHeRbSgUifI1fwlEQuV0TGLKxiBCq/K3ia2Z8YTQ
1
Retrieved attributes for 1 sites.
By implementing these authentication methods, you ensure secure and authorized interactions with the Pelican OpenAPI.
Best Practices
To optimize your experience with the Pelican OpenAPI, consider implementing the following best practices:
To obtain a copy of the Perl module, please contact Pelican Technical Support.
Create a Dedicated Developer User
For integration purposes, it’s advisable to create a separate, non-personal user account. This approach ensures clarity within the User Management section of the Pelican App regarding which credentials are designated for integration tasks.
- Historical Data Requests: If real-time data isn’t necessary, opt to request historical data over extended time ranges instead of continuous data pulls. This method reduces server load and enhances efficiency.
- Batch Queries for Thermostats: To retrieve data for all thermostats at a site, omit the selection criteria in your request. This technique allows you to gather data for the entire site in a single request, eliminating the need for multiple individual queries.
By adhering to these best practices, you can ensure efficient and effective interactions with the Pelican OpenAPI.
Rate Limites
API requests have no rate limits.