API

Specifications

Remote - About Remotes

Edit Jira

The remote feature of this API allows sending remote action to Stellantis vehicles using an internet connection.

Remote Features #

  • ❄️ Preconditioning: Remote preconditioning the vehicle.
  • 🔌 Charging: Start and Stop the recharge of the vehicle.
  • 💡 Lights: Remote to swith on / off lights.
  • 🔈 Horn: Remote vehicle horn activation.The eligibility api will provide possible state values for the vehicle.
  • 🔒 Immobilization: Requesting the vehicle for immobilization.
  • 🥷 Stolen: Remote operation to update stolen state and immobilization. Only one attribute can be used at a time.
  • 🔄 State: Refresh and retrieve vehicle status info.
  • 📍 Navigation: A remote to share GPS positions with the vehicle so it can navigate through those positions by driving from start (1st) to end (last) position.
  • 🔒 Locking: Remote Lock & Unlock allows to lock and unlock their vehicle.
  • 🥱 WakeUp: Remote to wake up a vehicle (so it can update its data).
  • 🚗 VehicleFinder: Remote to get vehicle’s present location.
  • 🚨 Tan: Remote operation to update Theft Alarm Notification suppression state and confirmation state. Only one attribute can be used at a time.
  • 👤 OnboardPersonalData: Enable user to delete personal data for the vehicle.

How does it work? #

When a remote action is sent to a vehicle, it will trigger notifications during the process. That’s why, before sending any remote, it’s necessary to set up a remote callback channel. If you are working with monitors already, it is almost the same as posting a monitor.

Callbacks allow to setup the notifications sent by the remote and the address of the targeted server and the retryPolicy and batch sending. Callbacks can be configured to be specific to certain remote types.

remote-callback-sequence

Then, it’s possible to send a remote action request using a vehicle ID and the channel ID.

When a remote command is sent to a vehicle, the callback server will receive several notifications as the action is being processed, checkout Notification and Errors for more information about these events.

  • Pending: The remote action is in processing (Accepted, Waking-Up, Send etc.). Several Pending events will be received.
  • Done: The remote action is complete (Success, Failure etc.).

remote-action-sequence