# psa-connectedcar *PSA B2C Connected Car API* # Introduction This is the description of the *Groupe PSA Connected Car V2 API*. The speccification is is based on **OpenAPI Specification version 3** and can be displayed via [ReDoc](https://github.com/Rebilly/ReDoc)a or [Swagger](http://swagger.io). This API allows applications to fetch data from the connected Vehicles data platform. # Authentication PSA Connected Car APIs uses the [OAuth 2.0](https://tools.ietf.org/html/rfc6749) protocol for authentication and Authorization. any application require a valid [Access Token](https://tools.ietf.org/html/rfc6749#section-1.4) to access to user data. # Errors Error codes returned by all REST APIs comply with the standard. Nevertheless, PSA Services (callers) need to have more complete data structures (even when the answer is not Http-OK) to better detail the type of error by providing application code, message and a debugging code(for investigation purposes). The http code of the response is managed by the protocol itself (in the header). **Errors are returned as a generic error response:** * ```xError``` object model. This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project: - API version: 4.0 - Package version: 4.0 - Build package: io.swagger.codegen.languages.PythonClientCodegen ## Requirements. Python 2.7 and 3.4+ ## Documentation for API Endpoints All URIs are relative to *https://api.groupe-psa.com/connectedcar/v4* Class | Method | HTTP request | Description ------------ | ------------- | ------------- | ------------- *TripsApi* | [**get_path_for_trip**](docs/TripsApi.md#get_path_for_trip) | **GET** /user/trips/{tid}/wayPoints | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_path_for_trip_0**](docs/TripsApi.md#get_path_for_trip_0) | **GET** /user/vehicles/{id}/trips/{tid}/wayPoints | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_telemetry_for_trip**](docs/TripsApi.md#get_telemetry_for_trip) | **GET** /user/trips/{tid}/telemetry | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_telemetry_for_trip_0**](docs/TripsApi.md#get_telemetry_for_trip_0) | **GET** /user/vehicles/{id}/trips/{tid}/telemetry | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_trip_by_vehicle**](docs/TripsApi.md#get_trip_by_vehicle) | **GET** /user/vehicles/{id}/trips/{tid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_trips_by_vehicle**](docs/TripsApi.md#get_trips_by_vehicle) | **GET** /user/trips/{tid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_trips_by_vehicle_0**](docs/TripsApi.md#get_trips_by_vehicle_0) | **GET** /user/trips/{tid}/ecoaching | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_trips_by_vehicle_1**](docs/TripsApi.md#get_trips_by_vehicle_1) | **GET** /user/vehicles/{id}/trips | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_trips_by_vehicle_2**](docs/TripsApi.md#get_trips_by_vehicle_2) | **GET** /user/vehicles/{id}/trips/{tid}/ecoaching | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_user_collision_by_tip_by_id**](docs/TripsApi.md#get_user_collision_by_tip_by_id) | **GET** /user/trips/{tid}/collisions/{cid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_user_collisions_by_trip_id**](docs/TripsApi.md#get_user_collisions_by_trip_id) | **GET** /user/trips/{tid}/collisions | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_user_trip_alert_by_aid**](docs/TripsApi.md#get_user_trip_alert_by_aid) | **GET** /user/trips/{tid}/alerts/{aid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_user_trip_alerts**](docs/TripsApi.md#get_user_trip_alerts) | **GET** /user/trips/{tid}/alerts | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_user_trips**](docs/TripsApi.md#get_user_trips) | **GET** /user/trips | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_vehicle_collision_by_tip_by_id**](docs/TripsApi.md#get_vehicle_collision_by_tip_by_id) | **GET** /user/vehicles/{id}/trips/{tid}/collisions/{cid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_vehicle_collisions_by_trip_id**](docs/TripsApi.md#get_vehicle_collisions_by_trip_id) | **GET** /user/vehicles/{id}/trips/{tid}/collisions | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_vehicle_trip_alert_by_aid**](docs/TripsApi.md#get_vehicle_trip_alert_by_aid) | **GET** /user/vehicles/{id}/trips/{tid}/alerts/{aid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *TripsApi* | [**get_vehicle_trip_alerts**](docs/TripsApi.md#get_vehicle_trip_alerts) | **GET** /user/vehicles/{id}/trips/{tid}/alerts | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *UserApi* | [**get_user**](docs/UserApi.md#get_user) | **GET** /user | User's information *VehiclesApi* | [**delete_monitordd**](docs/VehiclesApi.md#delete_monitordd) | **DELETE** /user/vehicles/{id}/monitors/{mid} | Delete a Monitor. OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_car_last_position**](docs/VehiclesApi.md#get_car_last_position) | **GET** /user/vehicles/{id}/lastPosition | Last position identified *VehiclesApi* | [**get_telemetry**](docs/VehiclesApi.md#get_telemetry) | **GET** /user/vehicles/{id}/telemetry | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_vehicle_alerts**](docs/VehiclesApi.md#get_vehicle_alerts) | **GET** /user/vehicles/{id}/alerts | *VehiclesApi* | [**get_vehicle_alerts_by_id**](docs/VehiclesApi.md#get_vehicle_alerts_by_id) | **GET** /user/vehicles/{id}/alerts/{aid} | *VehiclesApi* | [**get_vehicle_byid**](docs/VehiclesApi.md#get_vehicle_byid) | **GET** /user/vehicles/{id} | Details of vehicule *VehiclesApi* | [**get_vehicle_collision**](docs/VehiclesApi.md#get_vehicle_collision) | **GET** /user/vehicles/{id}/collisions | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_vehicle_collision_by_id**](docs/VehiclesApi.md#get_vehicle_collision_by_id) | **GET** /user/vehicles/{id}/collisions/{cid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_vehicle_maintenance**](docs/VehiclesApi.md#get_vehicle_maintenance) | **GET** /user/vehicles/{id}/maintenance | *VehiclesApi* | [**get_vehicle_monitors**](docs/VehiclesApi.md#get_vehicle_monitors) | **GET** /user/vehicles/{id}/monitors | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_vehicle_monitors_by_id**](docs/VehiclesApi.md#get_vehicle_monitors_by_id) | **GET** /user/vehicles/{id}/monitors/{mid} | OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**get_vehicle_status**](docs/VehiclesApi.md#get_vehicle_status) | **GET** /user/vehicles/{id}/status | Vehicle status. *VehiclesApi* | [**get_vehicles_by_device**](docs/VehiclesApi.md#get_vehicles_by_device) | **GET** /user/vehicles | List of vehicules *VehiclesApi* | [**set_fleet_vehicle_monitor_status**](docs/VehiclesApi.md#set_fleet_vehicle_monitor_status) | **PUT** /user/vehicles/{id}/monitors/{mid}/status | Set a new monitor status. OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**set_vehicle_monitor**](docs/VehiclesApi.md#set_vehicle_monitor) | **POST** /user/vehicles/{id}/monitors | Create a new Monitor. OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE *VehiclesApi* | [**update_fleet_vehicle_monitor**](docs/VehiclesApi.md#update_fleet_vehicle_monitor) | **PUT** /user/vehicles/{id}/monitors/{mid} | Update and existing Monitor. OUT OF 1ST RELEASE (R-LEV 1.1) SCOPE ## Documentation For Models - [Adas](docs/Adas.md) - [AdasParkAssist](docs/AdasParkAssist.md) - [Alert](docs/Alert.md) - [AlertEndPosition](docs/AlertEndPosition.md) - [AlertLinks](docs/AlertLinks.md) - [AlertMsgEnum](docs/AlertMsgEnum.md) - [Alerts](docs/Alerts.md) - [AlertsEmbedded](docs/AlertsEmbedded.md) - [Battery](docs/Battery.md) - [BoundedProgram](docs/BoundedProgram.md) - [ChargingStatusEnum](docs/ChargingStatusEnum.md) - [CircleZone](docs/CircleZone.md) - [CircleZoneCoordinates](docs/CircleZoneCoordinates.md) - [CollectionResult](docs/CollectionResult.md) - [Collision](docs/Collision.md) - [CollisionLinks](docs/CollisionLinks.md) - [CollisionObj](docs/CollisionObj.md) - [CollisionObjFront](docs/CollisionObjFront.md) - [Collisions](docs/Collisions.md) - [CollisionsEmbedded](docs/CollisionsEmbedded.md) - [CreatedAtField](docs/CreatedAtField.md) - [DataMonitorTrigger](docs/DataMonitorTrigger.md) - [DataTrigger](docs/DataTrigger.md) - [DefaultAlertPush](docs/DefaultAlertPush.md) - [DefaultAlertPushAttributes](docs/DefaultAlertPushAttributes.md) - [DoorsState](docs/DoorsState.md) - [DoorsStateOpening](docs/DoorsStateOpening.md) - [ECoaching](docs/ECoaching.md) - [ECoachingLinks](docs/ECoachingLinks.md) - [ECoachingScores](docs/ECoachingScores.md) - [Energy](docs/Energy.md) - [Engine](docs/Engine.md) - [EngineOil](docs/EngineOil.md) - [Environment](docs/Environment.md) - [EnvironmentLuminosity](docs/EnvironmentLuminosity.md) - [Event](docs/Event.md) - [EventLinks](docs/EventLinks.md) - [Extension](docs/Extension.md) - [ExtensionType](docs/ExtensionType.md) - [Geometry](docs/Geometry.md) - [Ignition](docs/Ignition.md) - [IndexRange](docs/IndexRange.md) - [Kinetic](docs/Kinetic.md) - [Lighting](docs/Lighting.md) - [Link](docs/Link.md) - [Maintenance](docs/Maintenance.md) - [MaintenanceLinks](docs/MaintenanceLinks.md) - [MaintenanceObj](docs/MaintenanceObj.md) - [Monitor](docs/Monitor.md) - [MonitorId](docs/MonitorId.md) - [MonitorLinks](docs/MonitorLinks.md) - [MonitorParameter](docs/MonitorParameter.md) - [MonitorParameterTriggerParam](docs/MonitorParameterTriggerParam.md) - [MonitorRef](docs/MonitorRef.md) - [MonitorRefLinks](docs/MonitorRefLinks.md) - [MonitorStatus](docs/MonitorStatus.md) - [MonitorStatusSetter](docs/MonitorStatusSetter.md) - [MonitorSubscribe](docs/MonitorSubscribe.md) - [MonitorSubscribeBatchNotify](docs/MonitorSubscribeBatchNotify.md) - [MonitorSubscribeRetryPolicy](docs/MonitorSubscribeRetryPolicy.md) - [MonitorTrigger](docs/MonitorTrigger.md) - [MonitorWebhook](docs/MonitorWebhook.md) - [MonitorWebhookAttributes](docs/MonitorWebhookAttributes.md) - [Monitors](docs/Monitors.md) - [MonitorsEmbedded](docs/MonitorsEmbedded.md) - [OverallAutonomy](docs/OverallAutonomy.md) - [Point](docs/Point.md) - [PolygonZone](docs/PolygonZone.md) - [Position](docs/Position.md) - [PositionProperties](docs/PositionProperties.md) - [Preconditioning](docs/Preconditioning.md) - [PreconditioningAirConditioning](docs/PreconditioningAirConditioning.md) - [PreconditioningProgram](docs/PreconditioningProgram.md) - [Privacy](docs/Privacy.md) - [Program](docs/Program.md) - [ProgramOccurence](docs/ProgramOccurence.md) - [Safety](docs/Safety.md) - [ServiceType](docs/ServiceType.md) - [Status](docs/Status.md) - [StatusEmbedded](docs/StatusEmbedded.md) - [StatusExtensionType](docs/StatusExtensionType.md) - [StatusLinks](docs/StatusLinks.md) - [TabLinks](docs/TabLinks.md) - [Telemetry](docs/Telemetry.md) - [TelemetryEmbedded](docs/TelemetryEmbedded.md) - [TelemetryEnum](docs/TelemetryEnum.md) - [TelemetryExtension](docs/TelemetryExtension.md) - [TelemetryExtensionType](docs/TelemetryExtensionType.md) - [TelemetryMessage](docs/TelemetryMessage.md) - [TelemetryMessageEmbedded](docs/TelemetryMessageEmbedded.md) - [TelemetryMessageVehicle](docs/TelemetryMessageVehicle.md) - [TelemetryMessageVehicleBrakingSystem](docs/TelemetryMessageVehicleBrakingSystem.md) - [TelemetryMessageVehicleTransmission](docs/TelemetryMessageVehicleTransmission.md) - [TelemetryMessageVehicleTransmissionGearbox](docs/TelemetryMessageVehicleTransmissionGearbox.md) - [TelemetryMessageVehicleTransmissionGearboxGear](docs/TelemetryMessageVehicleTransmissionGearboxGear.md) - [TelemetryMessageVehicleTransmissionGearboxMode](docs/TelemetryMessageVehicleTransmissionGearboxMode.md) - [TimeMonitorTrigger](docs/TimeMonitorTrigger.md) - [TimeRange](docs/TimeRange.md) - [TimeStamped](docs/TimeStamped.md) - [TimeTrigger](docs/TimeTrigger.md) - [TimeZoneMonitorTrigger](docs/TimeZoneMonitorTrigger.md) - [TimeZoneTrigger](docs/TimeZoneTrigger.md) - [Trip](docs/Trip.md) - [TripAvgConsumption](docs/TripAvgConsumption.md) - [TripLinks](docs/TripLinks.md) - [Trips](docs/Trips.md) - [TripsEmbedded](docs/TripsEmbedded.md) - [UpdatedField](docs/UpdatedField.md) - [Url](docs/Url.md) - [User](docs/User.md) - [UserEmbedded](docs/UserEmbedded.md) - [UserLinks](docs/UserLinks.md) - [Vect2D](docs/Vect2D.md) - [Vehicle](docs/Vehicle.md) - [VehicleEngine](docs/VehicleEngine.md) - [VehicleLinks](docs/VehicleLinks.md) - [VehicleOdometer](docs/VehicleOdometer.md) - [Vehicles](docs/Vehicles.md) - [VehiclesEmbedded](docs/VehiclesEmbedded.md) - [WayPoints](docs/WayPoints.md) - [WayPointsEmbedded](docs/WayPointsEmbedded.md) - [XError](docs/XError.md) - [ZoneMonitorTrigger](docs/ZoneMonitorTrigger.md) - [ZoneTrigger](docs/ZoneTrigger.md) - [ZoneTriggerPlace](docs/ZoneTriggerPlace.md) - [ZoneTriggerPlaceCenter](docs/ZoneTriggerPlaceCenter.md) ## Documentation For Authorization ## Vehicle_auth - **Type**: OAuth - **Flow**: implicit - **Authorization URL**: - **Scopes**: - **Collision_read**: read Collision related data - **Maintenance_read**: read Maintenance related data - **Status_read**: read Vehicle related status - **Telemetry_read**: read Telemetry related data - **Trip_read**: read Trip related data - **Vehicle_read**: read Vehicle related data - **alert_read**: read alert related data - **alert_write**: create, modify or delete alerte - **localisation_read**: read location related data ## client_id - **Type**: API key - **API key parameter name**: client_id - **Location**: URL query string ## realm - **Type**: API key - **API key parameter name**: x-introspect-realm - **Location**: HTTP header ## Author