Welcome to Thermoplan API
Thermoplan has developed this C2C API so that customers have the possibility to enrich their own internal systems with data from the ThermoplanConnect cloud. This data processing option is particularly useful for customers who already use additional IoT devices and want to maintain data with a single application.
The interface is transmitted and provided by ThermoplanConnect via a secure connection. The customer is responsible for connecting the interface to their own systems. Thermoplan AG provides a guide on how to access the API so that the data can be collected but is not responsible for any customer-side implementations.
C2C Streaming API
The C2C Streaming API provides a message-based interface for consuming real-time for products and events from your machines. Consuming the data from an Azure Event Hub and store it into your database.
C2C Query API
Our C2C Query API exposes data through a standardized, queryable HTTPS interface based on the OData v4 protocol.
The API provides access to machine fleet master data, machine connection status, machine maintenance, machine module (history) and machine settings.
C2C Query API
C2C Streaming API
Data
machine fleet master data
machine connection status
machine maintenance
machine module (history)
machine settings
machine events
products
Data format
JSON
See schemas: APIs: Details - ThermoplanConnect API Management
JSON
See schema: Streaming-API - ThermoplanConnect API Management
Technology
RESTful with OData support for query options (filtering, ordering, ...)
Azure Event Hub
How to consume
http client library, Postman for testing purposes, python scripts, ...
This list is not complete, there a further options to consume RESTful APIs.
Testing: Use the C2C Developer Portal test client
Option 1: Use any common library to consume from Azure Event Hub : Azure Event Hubs client library for .NET - Azure for .NET Developers | Microsoft Learn
Option 2: Use Azure Stream Analytics job to consume from Azure Event Hub: Process data using Stream Analytics - Azure Event Hubs | Microsoft Learn
This list is not complete, there a further options to consume Azure Event Hub data.
Tenant support
You get all the machine data for your tenant and subtenant you are assigned to.
You get all the machine data for your tenant and subtenant you are assigned to.
Authentication / Authorization
Only available after requesting the C2C Query API via Thermoplan support (support@thermoplanconnect.com).
OAuth 2.0 flow (client id + client secrect)
Use the access credentials from the profile page (login required): User: Profile - ThermoplanConnect API Management
Additional subscription key is required and can be created here: API Management
Only available after requesting the C2C Streaming API via Thermoplan support (support@thermoplanconnect.com).
Use the access credentials from the profile page (login required):
Request the API
Request access for C2C Query API via support@thermoplanconnect.com
Request access for C2C Streaming API via support@thermoplanconnect.com
Rate limit / polling interval
No rate limits
Reccommended data polling interval: every hour
No rate limits
Live data (delay of 5 seconds from real time)