Monitor - About Monitors
Monitoring is an event-based feature provided with this API, it allows to set up events patterns that will be tracked on Stellantis servers.
Monitors & Direct Request #
Direct Requesting is the classic way to use REST APIs. Requesting vehicle data is made using HTTP Request & Response, check out the API references for the list of available resources.
Monitoring offers another way to receive vehicle data by setting-up patterns & receiving events. When the pattern is triggered on Stellantis servers, it will send a notification through Firebase Cloud Messaging, HTTP or websocket. For example, a notification can be triggered when the oil level is low.
Monitor features #
Monitors offers 3 different kinds of different patterns that can be combined together:
- 🗺️ Zone Monitor: The monitor is triggered by a condition based on an area.
Example: leaving or entering a location. - ⏱️ Time Monitor: The monitor is triggered by scheduled time condition.
Example: when the vehicle is used during the night. - 🚗 Data Monitor: The monitor is triggered based on a rule made of vehicle data.
Example: opening of the doors, using the AC, oil temperature increasing too much, etc.
How Does it Work? #
First of all the monitors need to be set up using the appropriate API endpoints. Then, when Stellantis servers are receiving data from your car, the event engine will check if the conditions of your monitor are satisfied. If it is the case, it will trigger the notification.
Monitors offers a feature to process large amount of vehicle data. Although able to receive and process these events.
Set Up Monitors
Check out this tutorial in order to configure monitors.