How can we help?
Print

Categories:

OpenAPI

Power Control Module API

Power Control Module API Overview

UPDATED

The Pelican OpenAPI provides two primary API categories for managing Power Control Modules (PM5 Series), enabling you to control active statuses and schedules of connected electrical equipment.

Power Control Module API Categories

PowerOutput Attributes

Manage and retrieve the active statuses of the Power Control Module’s relays.

Key Features:

  • Control up to five independent electrical devices per module.

  • Compatible with various equipment, including exhaust fans, boilers, cooling towers, and lighting.

  • Allows for real-time adjustments to equipment operation.

PowerSchedule Attributes

Add, modify, delete, and retrieve schedules for the Power Control Module’s relay outputs.

Key Features:

  • Schedule equipment operation to optimize energy usage and efficiency.

  • Supports both one-time and recurring schedules.

  • Provides flexibility in managing equipment run-times based on specific needs.

Best Practices for Using the Thermostat API

Optimize API Requests:

  • Batch requests when controlling multiple relays instead of making separate calls.
  • Only request necessary attributes to improve API response time.

Use Scheduled Control Instead of Continuous Polling:

  • Instead of frequently checking relay statuses, schedule operations in advance to reduce unnecessary API load.
  • When possible, use PowerSchedule rather than manually setting relay states via PowerOutput.

Follow Standard Date Formats:

  • Always use ISO 8601 timestamps (yyyy-mm-ddTHH:MM:SSZ).

Secure Your API Requests:

  • Authenticate using username/password or token-based authentication via MySites.
  • Use token-based authentication via MySites when managing multiple locations.
  • Always send API requests over SSL (HTTPS) for security.

Avoid Scheduling Conflicts:

  • Ensure PowerSchedule events do not overlap or conflict with existing automation rules.
  • If you need to override a schedule, use PowerOutput carefully to prevent unintended behavior.

By following these best practices, you can maximize the efficiency and reliability of your Power Control Module API integration, reducing unnecessary API calls while ensuring precise equipment control. 

Table of Contents