An introduction to the Realer platform

The Realer platform allows users to control and automate their devices, empowering developers to craft Internet of Things (IoT) solutions to manage connected things, inspire action, and synergize services.

This guide focuses on control-device integrations through the iot/v1 HTTP contract.

Control-device interaction

At a high level, a control device follows a structured loop:

1. Authentication with Realer
   The control device requests an OAuth 2.0 Bearer access token from the Realer platform and uses it to authorize subsequent iot/v1 requests.
2. Command and sensor data acquisition
   Upon authentication, the device retrieves its command and sensor catalog for local processing and execution of actions through connected actuators, while concurrently gathering environmental data through connected sensors.
3. Feed-data ingestion
   Subsequently, the control device sends command acknowledgements and sensor readings through the feed-data ingestion contract for analysis and current-state updates.
4. Loop iteration and token renewal
   The control device re-enters the loop at step 2, perpetuating its functionality. In the event of access-token expiration, the device reinitiates the authentication process from step 1 before continuing the loop.

What you need

To begin developing your own control device that seamlessly integrates with the Realer platform, here is what you will need:

• An electronics device
  You will need an electronics device capable of connecting to the Internet. Consider options like Arduino, Raspberry Pi, STM32, ESP32, or others that suit your project requirements.
• Realer API keys
  Get API keys to register a new control device on Realer. These client credentials are used at the OAuth token endpoint to obtain Bearer access tokens for the device API. Once you receive your API keys, you can jump into experimentation and development.
• Programming knowledge
  Developing control devices requires proficiency in coding. You should know languages like C/C++, Python, or Java to program your control device.
• Documentation and resources
  Explore our API documentation and resources to seamlessly integrate your devices with Realer. Feel free to reach out to us for further assistance or clarification.

With these essentials in hand, you are ready to embark on your journey with the Realer platform. Let's bring your control device ideas to life in the exciting world of IoT.