# Conundra Vehicle API

The Vehicle API provides endpoints for managing vehicles used in planning operations.


Version: 0.0.3

## Servers

Vehicle API Production
```
https://api.conundra.eu/vehicle/v1
```

## Security

### clientCredentials

This API uses OAuth2 with the Client Credentials flow for M2M communication. Client ID ans secret should be provided as a HTTP Basic Auth header.


Type: oauth2

## Download OpenAPI description

[Conundra Vehicle API](https://developer.conundra.eu/_bundle/apis/vehicles/vehicle-api.yaml)

## Health check

Miscellaneous endpoints for general API functionality

### Health check

 - [GET /ping](https://developer.conundra.eu/apis/vehicles/vehicle-api/health/ping.md): The ping-endpoint can be used for validating a connection with the application. It will authenticate the caller and respond pong if everything is set-up correctly.

## Vehicle [EXPERIMENTAL]

Endpoints for managing vehicles.


### Upsert Vehicle

 - [PUT /vehicles/{business_id}](https://developer.conundra.eu/apis/vehicles/vehicle-api/vehicle/upsertvehicle.md): Create or update a Vehicle. A unique ID (business_id) is required to identify the Vehicle. 
Calling this endpoint with an existing business_id will update the Vehicle.

Modifying (or retrieving) a Vehicle will provide the caller with a version number for this Vehicle. 
This version can be passed to the _upsert_ endpoint as a _weak ETag_ in the If-Match header. 
This allows the caller to ensure that the Vehicle has not been modified since the last time it was retrieved.

### Get Vehicle

 - [GET /vehicles/{business_id}](https://developer.conundra.eu/apis/vehicles/vehicle-api/vehicle/getvehicle.md): Get an existing Vehicle, defined by their business_id.

### Delete Vehicle

 - [DELETE /vehicles/{business_id}](https://developer.conundra.eu/apis/vehicles/vehicle-api/vehicle/deletevehicle.md): Delete a Vehicle, defined by their business_id.