github/psa_car_controller
1
0
Fork 0
mirror of https://github.com/flobz/psa_car_controller.git synced 2026-08-21 17:06:18 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
ebc0188ba373da9de14d6edade070af4cd29d97c
psa_car_controller/api_spec.md
T
Florian Bezannier 8c39143c60 add api doc
2020-11-15 12:20:10 +01:00

224 lines
14 KiB
Markdown
Raw Blame History

# 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
Reference in New Issue View Git Blame Copy Permalink