web:access_rest_api
This is an old revision of the document!
Table of Contents
AGTEK Access REST Api
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.
Use Cases
The Web API (AKA REST) will likely be used in the following use cases:
- Track viewing operation (AKA TrackManager light)
- Replacement of V1 access.agtek.com application
- CRUD of customer admin functions
- Running of reports
- Supporting mass market items (non-licensed)
- Server monitoring functionality.
- Web applications are running as separate WAR apps, perhaps on different machines.
- REST API perhaps used for background operations in IOS operations.
Method Breakdown
| Sub-API | Method Name | Return Value | Notes |
| CONNECTION | |||
| connect() | StorageServer | ||
| authenticate() | |||
| authenticateResetPassword() | |||
| disconnect() | |||
| getAllAnnouncements() | Announcement* | ||
| ASSOCIATION | |||
| getAssociations() | Association* | ||
| addAssociation() | Association | ||
| updateAssociation() | Association | ||
| deleteAssociation() | Association | ||
| CONFIGURATION | |||
| getAllConfigurations() | Configuration* | ||
| getConfiguration() | Configuration | ||
| updateConfiguration() | Configuration | ||
| getConfigurationData() | ConfigurationData | ||
| setConfigurationData() | void | ||
| FILEAPI | |||
| createFolder() | StoredFolder | ||
| createPublicUrl() | String url | ||
| deleteFile() | void | ||
| deletePublicUrl() | void | ||
| downloadFile() | to file… tbd | ||
| downloadVersion() | to file… tbd | ||
| getAccountInfo() | |||
| getFolder() | StoredFolder | ||
| getVersions() | StoredFile+ | ||
| getStoredFile() | StoredFile | ||
| moveFile() | void | ||
| renameFile() | void | ||
| renameFolder() | void | ||
| setDescriptio() | void | ||
| uploadFolder() | StoredFolder | ||
| PROJECTS | |||
| addProject() | Project | ||
| updateProject() | Project | ||
| getProjects() | Project* | ||
| deleteProject() | void | ||
| archiveProject() | StoredFile | ||
| restoreProject() | Project | ||
| getWorkingTime() | WorkingTime | ||
| getWorkingTime() | WorkingTime* | ||
| updatingWorkingTime() | WorkingTime | ||
| deleteWorkingTime() | void | ||
| REPORTS | |||
| getReportFormats() | String+ | ||
| getReports() | String+ | ||
| runReport() | void | ||
| getActiveProducts() | String+ | ||
| ADMIN | All are customer admin functions as defined in current API | ||
| getUsers() | StorageUser* | ||
| addUser() | StorageUser | ||
| deleteUser() | boolean | ||
| updateUser() | StorageUser | ||
| getAllLicenses() | LicenseKey* | ||
| removeLicenseUser() | void | ||
| addLicenseUser() | void | ||
| updateLicenseCheckoutTime() | LicenseKey | ||
| getLicenseLog() | |||
| LICENSE | Not supported in V1 | ||
| SUPPORT | Limited to viewing only operations | ||
| TRACKING | Plus traditional POSITION API | ||
| getSerialNumbers() | String* | ||
| updateGpsStats() | GpsStat | ||
| updateGpsStats() | GpsStat | inp telemetry, needed in web? | |
| getGpsStats() | GpsStat+ | ||
| getGpsTelemetry() | GpsTelemetry | ||
| getTracks() | Track* | ||
| getTrack() | Track | ||
| deleteTrack() | void | ||
| moveTrack() | Track | ||
| combineTrack() | Track | ||
| updateTrack() | void | ||
| getTrackStats() | TrackStats | ||
| getTrackSummaryStats() | TrackStats | ||
| updateTrackStats() | TrackStats | ||
| VEHICLES | |||
| getVehicles() | Vehicle* | ||
| addVehicle() | Vehicle | ||
| updateVehicle() | Vehicle | ||
| deleteVehicle() | Vehicle |
web/access_rest_api.1454030140.txt.gz · Last modified: 2016/01/29 01:15 by mjallison
