Fan Selection Tool (FST) External Integration with Third-Party Applications

Leveraging APIs and Excel for Enhanced Connectivity

1 Introduction

The Infinitum Fan Selection Tool (FST) is designed to support HVAC fan system design, streamline workflows, and generate submittal packages.

To support customer workflows, FST can be integrated with third-party software applications using:

1. Application Programming Interfaces (APIs) for real-time system-to-system communication
2. Excel-based integrations for data exchange, analysis, and reporting

Access to detailed API documentation and advanced integration capabilities requires: 

1. A valid Non-Disclosure Agreement (NDA)
2. A commercial agreement (evaluated on a case-by-case basis)

2 Getting Started with External Integration

Before implementing an integration, organizations should ensure the following prerequisites are in place:

1. Define integration objectives

   Determine the intended use case (e.g., data synchronization, reporting, automated fan selection, or workflow automation).

2. Review documentation
   • Infinitum FST integration capabilities
   • Target platform (e.g., BMS, design software, internal tools)
   • Request API documentation from Infinitum if needed

3. Confirm access and credentials

   Ensure you have the required:

   • API keys or authentication credentials
   • User permissions within the FST

4. Validate in a test environment

Test the integration in the approach in a non-production sandbox environment before deploying to production systems.

3  Getting Started with API Integration

To begin integrating Infinitum FST using APIs, follow these steps:

3.1 Access API Endpoints:

API endpoint URLs and authentication credentials are provided by Infinitum upon request.

To obtain access:

1. Contact Infinitum to request API documentation
2. Execute a valid NDA and commercial agreement (if required)
3. Receive API credentials (e.g., API keys or authentication token)

3.2      Available API endpoints (Limited Release)

The following endpoints are currently available on a limited basis.

1. Fan Selection Endpoint
   • Purpose: Retrieve a list of fan systems that match specified performance requirements.
   • Required Inputs:
     • Airflow (CFM)
     • Static Pressure (w.g.)
   • Optional Inputs:
     • Additional filtering or performance parameters (default values applied if not provided)
   • Response: Returns a list of matching fan systems in JSON format.
2. Motor Selection Endpoint
   • Purpose: Retrieve Infinitum motor options based on defined duty point requirements.
   • Inputs: Returns a list of matching Infinitum motor configurations in JSON format
   • Alternative Option: The Infinitum Motor Selection Tool (MST) API can also be used to retrieve motor selections.
     • Full MSTP API documentation available at https://mst.goinfinitum.com/docs/api
3. Fan Chart Endpoint
   • Purpose: Generate a performance chart for a selected fan configuration.
   • Inputs: Operating parameters (e.g., airflow, pressure)
   • Response: Returns a base64 JPEG image of the fan performance chart string for a given fan

3.3      Implement Basic Requests:

Once access is established, begin by validating connectivity using a simple API request.

Recommended approach:

1. Start with the Fan Selection endpoint using minimum required inputs (airflow and static pressure)
2. Confirm that:
   • The request is successfully authenticated
   • A valid JSON response is returned
3. Review the response structure and validate that results align with expected performance ranges

This step ensures that the integration is functioning correctly before expanding to more advanced use cases.

4        Getting Started with Excel Integration

Excel-based integration provides a simpler alternative to APIs for users who prefer working with structured datasets or do not require real-time system connectivity.

4.1      Access Fan Data Tables

Infinitum provides Excel-based fan data tables that include performance characteristics such as:

• Airflow
• Static pressure

The Excel tables enable offline analysis and modeling. They are less dynamic than APIs but easier to implement. Contact Infinitum to obtain the latest FST Fan data tables.

4.2      Sample Excel table and corresponding chart

4.3 When to Use Excel vs API

5 Best Practices for Integration

1. Validate data formats and units
   Ensure consistency in units (e.g., airflow, pressure) and data structures between Infinitum FST and external systems to avoid calculation or selection errors.
2. Leverage official API documentation
   Use the WEBFAN WebAPI Functional Specification for detailed endpoint definitions, input parameters, and response structures.
3. Start with controlled test cases
   Validate integration logic using known duty points and expected outputs before scaling to broader use.
4. Implement error handling and validation
   Ensure your system can handle incomplete inputs, unexpected responses, or failed requests gracefully.
5. Monitor and maintain integrations
   Regularly review integration performance and update scripts or workflows to align with changes in APIs, data tables, or system requirements.

6 Contact Information

For assistance with Infinitum FST integration, please contact:

• Email: support@goInfinitum.com
• Support Center: support.goInfinitum.com
• Website for documentation and resources: Infinitum Fan Systems