Fleet Freedom
Main Site
Overview
WebSocket
JavaScript
Behaviours
Provisioning
Pictures
Reports
Events
Return to site

Pictures API Reference

version 4.2.0
© 2022 Trak iT Wireless Inc.
https://img.fleetfreedom.com/<operation>/pictureId?ghostId=ghostId&options=values

Supported MIME types

The MIME (Content-Type header) of any image uploaded must be one of these values:

  1. image/jpg or image/jpeg
  2. image/png
  3. image/gif

Upload Response fields

Properties
Property Type Description
errorCode ErrorCode A code describing the error processing this request (if any).
message string A human readable message describing the error processing this request (if any).
accepted object{string:Picture} This is a dictionary of Pictures which were successfully uploaded to the company. The key in the object corresponds to the field name used in the upload request.
rejected object{string:ErrorCode} This is a dictionary of failure messages for the images which did not upload. The key in the object corresponds to the field name used in the upload request.

Viewing, Re-sizing, and Cropping

https://img.fleetfreedom.com/photo/pictureId?ghostId=ghostId
https://img.fleetfreedom.com/photo/pictureId?ghostId=ghostId&size=maxWidthOrHeight
https://img.fleetfreedom.com/photo/pictureId?ghostId=ghostId&size=maxWidth,maxHeight
https://img.fleetfreedom.com/photo/pictureId?ghostId=ghostId&size=left,top,maxWidth,maxHeight

Icons

https://img.fleetfreedom.com/icon/iconId?ghostId=ghostId
https://img.fleetfreedom.com/icon/iconId?ghostId=ghostId&glyph=glyphIndex

Task Signatures

https://img.fleetfreedom.com/signature/taskId?ghostId=ghostId
https://img.fleetfreedom.com/signature/taskId?ghostId=ghostId&rotate=mode
https://img.fleetfreedom.com/signature/taskId?ghostId=ghostId&size=maxWidthOrHeight
https://img.fleetfreedom.com/signature/taskId?ghostId=ghostId&rotate=mode&size=maxWidthOrHeight

HTTP Response Status codes

Code Description
200 OK!
401 Access denied or session invalid
403 Permission denied
404 Unknown image, icon, or glyph.
500 Internal service error

Picture and Signature rotation mode

Mode Description
none (default) No rotation is performed.
landscape Rotates clockwise if the signature is taller than it is wide.
landscape-counter Same as "landscape", but rotates counter-clockwise.
portrait Rotates clockwise if the signature is wider than it is tall.
portrait-counter Same as "portrait", but rotates counter-clockwise.
Trak iT® Wireless and Fleet Freedom® are Trademarks of Trak iT® Wireless Inc.
All content contained within this site is the property of Trak iT® Wireless unless otherwise stated.