WEB API

accessing party for end-users

Remote - Server Specification

Info: Stellantis Accessing Party for End-Users API for ex Groupe PSA brands (Citroën, DS, Peugeot, Opel and Vauxhall) is available only on request.

In order to receive notifications sent by Remotes, a server is required for reception and processing. This tutorial details the configuration of this server.

Response to Notification

callback-sequence

When the server receives a notification from a remote, it should always return an HTTP response, if it’s not the case, the Remote will enter retry policy.

It is important that the reception server follows the following rules regarding HTTP status:

  • HTTP 200 OK: when the notification has been received (no matter if the system failed during the processing of this notification).
  • HTTP 500 Internal Server Error: the notification hasn’t been received.

200 OK should always be the response of the server if it received the notification. It should not be taken into account if the server success or not in the processing of this notification. In any case it is always possible to retrieve the state of a vehicle using the REST API.

These HTTP status are the only one supported by Stellantis notification system. Please do not use any other HTTP status. Otherwise, it could lead to a failure regarding following notification (or retry policy).

Server Specification

The reception server needs to be configured to read & process the notifications. Below is the server template specification, it describes the format of the notification.

Note: HTTPS must be supported and a certificate issued by a trusted public and known CA must be provided. Indeed, the URL of the server must be the same as the one specified when the callback is created.