#Vehicle avatar

#API actions

API path: /vehicle/avatar.

#assign

Assigns icon_id (from standard icon set) to specified vehicle.

required sub-user rights: vehicle_update

#Parameters

icon_id can be null – this means that uploaded avatar should be used instead of icon.

#Examples

curl -X POST 'https://api.mergroup.be/vehicle/avatar/assign' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "vehicle_id": 127722, "icon_id": 1342}'

https://api.mergroup.be/vehicle/avatar/assign?hash=a6aa75587e5c59c32d347da438505fc3&vehicle_id=127722&icon_id=1342

Response

{
  "success": true
}

Errors

• 201 – Not found in the database - when vehicle with vehicle_id not found.

#upload

Uploads avatar image for specified vehicle.
Then it will be available from https://api.mergroup.be/<api_static_path>/vehicle/avatars/<file_name>
e.g. https://api.mergroup.be/static/vehicle/avatars/abcdef123456789.png.

required sub-user rights: vehicle_update

avatar_file_name returned in response and will be returned from /vehicle/list.

MUST be a POST multipart request (multipart/form-data),
with one of the parts being an image file upload (with the name "file").

File part mime type must be one of :

• image/jpeg
• image/pjpeg
• image/png
• image/gif
• image/webp

#Parameters

If redirect_target passed a return redirect to response=<urlencoded response json>.

#Response

{
  "success": true,
  "value": "abcdef123456789.png"
}

• value - string. Avatar file name.

#Errors

• 201 – Not found in the database - when vehicle with vehicle_id not found.
• 233 – No data file - if file part not passed.
• 234 – Invalid data format - if passed file with unexpected mime type.
• 254 – Cannot save file - on some file system errors.