Tire and brake wear update

The tire and brake wear estimator returns the level of wear expressed in percent and the autonomy in kilometer.

It is possible to update the distance and the wear percentage based on observations made by a mechanic or during a technical inspection or a maintenance intervention on the vehicle.

In the case of a replacement, the distance and the wear must be set back to 0 km and 0% for the new component.

circle-info

If you have your admin API key, you can try the API via this linkarrow-up-right.

Update vehicle wear

put
Authorizations
DriveKit-Admin-API-KeystringRequired
Path parameters
vehicleIdstringRequired
Header parameters
DriveKit-Admin-API-KeystringRequired

Admin API Key

Content-TypestringRequiredDefault: application/json
Body
componentintegerRequired

Component to update. Component considered for the update: (1) Tires (2) Brakes

distancenumberRequired

Distance traveled with the component in kilometer min. = 0 km / max. = 300 000 km

driveintegerRequired

Drivetrain considered for the update: (1) Front drive (2) Rear drive

wearnumberRequired

Level of wear observed for the considered component. This value is in percent (min. = 0% / max. = 100%)

Responses
chevron-right
200

OK

application/json
analyzedDistancenumberRequired

Analyzed distance with the app

distancenumberRequired

total distance travelled by the vehicle

offsetDistancenumberRequired

offset between the total distance and the analyzed distance

changeDatestring · dateRequired
wearnumberRequired
autonomynumberRequired
wearRatenumberRequired
put
/drivekit/admin/vehicles/{vehicleId}/wear

Request body

The table below summarizes the content of a request body.

Field
Type
Description

component

integer

Component considered for the update

Allowed values: 1 (tires), 2 (brakes)

drive

integer

Drivetrain considered for the update

Allowed values: 1 (front drive), 2 (rear drive)

wear

number

Level of wear observed for the considered component (in %)

Min: 0% Max: 100%

distance

number

Distance traveled with the component (in km)

Min: 0 Max: 300 000

Recalibration Guidelines

  • The recalibration date is set to the request date.

  • The parameters wear and distance are required fields.

  • When a component is replaced:

    • wearPct is set to 0%

    • declaredDistance is set to 0 km

    • All synthesis data is reset automatically

circle-exclamation

Body samples

To declare that the front tires of the vehicle have a wear level of 40% after 14,000 km, the body of the request is as follows:

To declare that the rear brakes of the vehicle have just been changed, the body of the request must be as shown below:

Last updated

Was this helpful?