A REST API into the AGTEK Access system needs to provide full access to the Access server (npi), and it is desirable to mimic the desktop API in terms of API granularity and specificity.

The Web API (AKA REST) will likely be used in the following use cases, in relative priority order:

• AGTEK Access file client
• Replacement of V1 access.agtek.com application
  • CRUD of customer admin functions
  • Running of reports
• Supporting mass market items (non-licensed)
• Server monitoring functionality.
• Track viewing operation (AKA TrackManager light)

Implementation notes:

• Web applications are running as separate WAR apps, perhaps on different machines.
  • May need separate instance of REST API for each machine to avoid cross site scripting calls.
• REST API perhaps used for background operations in IOS operations.

If the method succeeds, ack is true. Any error will cause ack to be false, and code set to the StorageException value returned by the server. In most cases the string value err is set to the description provided by the error.

 { ack: true|false,
   code: 0 | code,
   err: "error description"
 }

Other JSON structures may be returned from a method. In each case the objects returned are wrapped as a GenericResponse. For instance getAllAnnouncements() returns

 { ack: true|false
   code: 0 | code,
   err : "error description"
   [ Announcement* ]
 }

Where Announcement is:

 {
    id: integer,
    expire: long, (mSec)
    text: "String of announcement"
 }  

Other return objects possible are: StoredItem

 {
    handle      : int-value,
    name        : string,
    description : string,
    isFolder    : boolean,
    size        : long,
    children: [ StoredItem* ]
 }
 

ApplicationState return from connection/open or connection/check

 {
    userid: string,
    token: string,
    lastPath: string
 }
 

AccountInfo

 {
    user: string,
    userid: string,
    totalSpace: long,
    usedSpace: long
 }
 

StorageUser (minimal needed for admin functions)

 {
    handle: integer,
    customerId: string,
    userId: string,
    firstName: string,
    lastName: string,
    phone: string,
    role: string
 }
 

LicenseKey (minimal needed for admin functions)

 {
    handle: integer,
    type: integer,
    number: string,
    customerId: string,
    maxCheckoutPeriod: long,
    dueDate: long,
    checkoutUser: string,
    checkoutUserPhone: string
 }
 

Project

 {
    handle: integer,
    name: string,
    description: string,
    lastTrackTime: long,
    modifiedTime: long,
    status: integer,
    trackCount: integer
 }
 

WorkingTime

 {
    projectHandle: integer,
    dayStart: long,
    morningStart: long,
    clipToStart: boolean,
    morningEnd: long,
    clipToMidday: boolean,
    afternoonStart: long,
    clipToEnd: boolean,
    afternoonEnd: long
 }
 

Track

 {
    handle: integer,
    trackerAlias: string,
    trackerSerial: string,
    projectHandle: integer,
    discoveryTime: long,
    startTime: long,
    endTime: long,
    totalPoints: long,
    fixType: integer, 
    attributes: object
 }
 

TrackPoints

 {
    count: integer,
    [ Point ]
 }
 

Point

 {
    time: long,
    lat: double,
    lon: double,
    alt: double
 }
 

Tracker

 {
    serial: string,
    alias: string,
    lastLat: double,
    lastLon: double,
    lastAlt: double,
    lastTime: long,
    totalPoints: integer
 }

Telemetry

 {
    serial: string,
    time: long,
    channel: int,
    value: numeric | string (depends on channel type)
 }
 

Vehicle

 {
    assetId: string,
    type: integer,
    status: integer,
    description: string,
    color: integer, (RGBA 32bit value)
    avgLoad: double
 }