aboutsummaryrefslogtreecommitdiff
path: root/swagger.json
diff options
context:
space:
mode:
authorDan <djr2468@gmail.com>2023-04-03 17:17:48 +0100
committerDan <djr2468@gmail.com>2023-04-03 17:17:48 +0100
commit1019243f07cdd026b573af593323830e9ebd0333 (patch)
tree224b3f33b7eaa2aa6b7ab1af0ecf66165e791af2 /swagger.json
parent0fc695a4c1a09ef9d33ea2fd0658f6dece989381 (diff)
downloadtrackermap-server-1019243f07cdd026b573af593323830e9ebd0333.tar.gz
trackermap-server-1019243f07cdd026b573af593323830e9ebd0333.tar.bz2
trackermap-server-1019243f07cdd026b573af593323830e9ebd0333.zip
Further review changes
Diffstat (limited to 'swagger.json')
-rw-r--r--swagger.json7068
1 files changed, 3526 insertions, 3542 deletions
diff --git a/swagger.json b/swagger.json
index d3a83ba76..5a7349da8 100644
--- a/swagger.json
+++ b/swagger.json
@@ -1,3542 +1,3526 @@
-{
- "openapi": "3.0.1",
- "info": {
- "title": "Traccar",
- "version": "5.6",
- "description": "Traccar GPS tracking server API documentation. To use the API you need to have a server instance. For testing purposes you can use one of free [demo servers](https://www.traccar.org/demo-server/). For production use you can install your own server or get a [subscription service](https://www.traccar.org/product/tracking-server/).",
- "contact": {
- "name": "Traccar Support",
- "url": "https://www.traccar.org/",
- "email": "support@traccar.org"
- },
- "license": {
- "name": "Apache 2.0",
- "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
- }
- },
- "servers": [
- {
- "url": "https://demo.traccar.org/api",
- "description": "Demo Server 1"
- },
- {
- "url": "https://demo2.traccar.org/api",
- "description": "Demo Server 2"
- },
- {
- "url": "https://demo3.traccar.org/api",
- "description": "Demo Server 3"
- },
- {
- "url": "https://demo4.traccar.org/api",
- "description": "Demo Server 4"
- },
- {
- "url": "https://server.traccar.org/api",
- "description": "Subscription Server"
- },
- {
- "url": "http://{host}:{port}/api",
- "description": "Other Server",
- "variables": {
- "host": {
- "default": "localhost"
- },
- "port": {
- "enum": [
- "8082",
- "80"
- ],
- "default": "8082"
- }
- }
- }
- ],
- "security": [
- {
- "basicAuth": []
- }
- ],
- "tags": [
- {
- "name": "Server",
- "description": "Server information"
- },
- {
- "name": "Session",
- "description": "User session management"
- },
- {
- "name": "Devices",
- "description": "Device management"
- },
- {
- "name": "Groups",
- "description": "Group management"
- },
- {
- "name": "Users",
- "description": "User management"
- },
- {
- "name": "Permissions",
- "description": "User permissions and other object linking"
- },
- {
- "name": "Positions",
- "description": "Retrieving raw location information"
- },
- {
- "name": "Events",
- "description": "Retrieving event information"
- },
- {
- "name": "Reports",
- "description": "Reports generation"
- },
- {
- "name": "Notifications",
- "description": "User notifications management"
- },
- {
- "name": "Geofences",
- "description": "Geofence management"
- },
- {
- "name": "Commands",
- "description": "Sending commands to devices and stored command management"
- },
- {
- "name": "Attributes",
- "description": "Computed attributes management"
- },
- {
- "name": "Drivers",
- "description": "Drivers management"
- },
- {
- "name": "Maintenance",
- "description": "Maintenance management"
- },
- {
- "name": "Calendars",
- "description": "Calendar management"
- },
- {
- "name": "Statistics",
- "description": "Retrieving server statistics"
- }
- ],
- "paths": {
- "/commands": {
- "get": {
- "summary": "Fetch a list of Saved Commands",
- "tags": [
- "Commands"
- ],
- "description": "Without params, it returns a list of Saved Commands the user has access to",
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Saved Command",
- "tags": [
- "Commands"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/commands/{id}": {
- "put": {
- "summary": "Update a Saved Command",
- "tags": [
- "Commands"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Saved Command",
- "tags": [
- "Commands"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/commands/send": {
- "get": {
- "summary": "Fetch a list of Saved Commands supported by Device at the moment",
- "description": "Return a list of saved commands linked to Device and its groups, filtered by current Device protocol support",
- "tags": [
- "Commands"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- }
- },
- "400": {
- "description": "Could happen when the user doesn't have permission for the device",
- "content": {}
- }
- }
- },
- "post": {
- "summary": "Dispatch commands to device",
- "description": "Dispatch a new command or Saved Command if _body.id_ set",
- "tags": [
- "Commands"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "Command sent",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- },
- "202": {
- "description": "Command queued",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- }
- },
- "400": {
- "description": "Could happen when the user doesn't have permission or an incorrect command _type_ for the device",
- "content": {}
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/commands/types": {
- "get": {
- "summary": "Fetch a list of available Commands for the Device or all possible Commands if Device ommited",
- "tags": [
- "Commands"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "description": "Internal device identifier. Only works if device has already reported some locations",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "protocol",
- "in": "query",
- "description": "Protocol name. Can be used instead of device id",
- "schema": {
- "type": "string"
- }
- },
- {
- "name": "textChannel",
- "in": "query",
- "description": "When `true` return SMS commands. If not specified or `false` return data commands",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/CommandType"
- }
- }
- }
- }
- },
- "400": {
- "description": "Could happen when trying to fetch from a device the user does not have permission",
- "content": {}
- }
- }
- }
- },
- "/devices": {
- "get": {
- "summary": "Fetch a list of Devices",
- "description": "Without any params, returns a list of the user's devices",
- "tags": [
- "Devices"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "id",
- "in": "query",
- "description": "To fetch one or more devices. Multiple params can be passed like `id=31&id=42`",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "uniqueId",
- "in": "query",
- "description": "To fetch one or more devices. Multiple params can be passed like `uniqueId=333331&uniqieId=44442`",
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Device"
- }
- }
- }
- }
- },
- "400": {
- "description": "No permission",
- "content": {}
- }
- }
- },
- "post": {
- "summary": "Create a Device",
- "tags": [
- "Devices"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Device"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Device"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/devices/{id}": {
- "put": {
- "summary": "Update a Device",
- "tags": [
- "Devices"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Device"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Device"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Device",
- "tags": [
- "Devices"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/devices/{id}/accumulators": {
- "put": {
- "summary": "Update total distance and hours of the Device",
- "tags": [
- "Devices"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/DeviceAccumulators"
- }
- }
- },
- "required": true
- },
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/groups": {
- "get": {
- "summary": "Fetch a list of Groups",
- "description": "Without any params, returns a list of the Groups the user belongs to",
- "tags": [
- "Groups"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Group"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Group",
- "tags": [
- "Groups"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Group"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Group"
- }
- }
- }
- },
- "400": {
- "description": "No permission",
- "content": {}
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/groups/{id}": {
- "put": {
- "summary": "Update a Group",
- "tags": [
- "Groups"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Group"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Group"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Group",
- "tags": [
- "Groups"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/permissions": {
- "post": {
- "summary": "Link an Object to another Object",
- "tags": [
- "Permissions"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Permission"
- }
- }
- },
- "required": true
- },
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- },
- "400": {
- "description": "No permission",
- "content": {}
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Unlink an Object from another Object",
- "tags": [
- "Permissions"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Permission"
- }
- }
- },
- "required": true
- },
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/positions": {
- "get": {
- "summary": "Fetches a list of Positions",
- "description": "We strongly recommend using [Traccar WebSocket API](https://www.traccar.org/traccar-api/) instead of periodically polling positions endpoint. Without any params, it returns a list of last known positions for all the user's Devices. _from_ and _to_ fields are not required with _id_.",
- "tags": [
- "Positions"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "description": "_deviceId_ is optional, but requires the _from_ and _to_ parameters when used",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "id",
- "in": "query",
- "description": "To fetch one or more positions. Multiple params can be passed like `id=31&id=42`",
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Position"
- }
- }
- },
- "text/csv": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Position"
- }
- }
- },
- "application/gpx+xml": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Position"
- }
- }
- }
- }
- }
- }
- }
- },
- "/server": {
- "get": {
- "summary": "Fetch Server information",
- "tags": [
- "Server"
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Server"
- }
- }
- }
- }
- }
- },
- "put": {
- "summary": "Update Server information",
- "tags": [
- "Server"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Server"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Server"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/session": {
- "get": {
- "summary": "Fetch Session information",
- "tags": [
- "Session"
- ],
- "parameters": [
- {
- "name": "token",
- "in": "query",
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- }
- },
- "404": {
- "description": "Not Found",
- "content": {}
- }
- }
- },
- "post": {
- "summary": "Create a new Session",
- "tags": [
- "Session"
- ],
- "requestBody": {
- "content": {
- "application/x-www-form-urlencoded": {
- "schema": {
- "required": [
- "email",
- "password"
- ],
- "properties": {
- "email": {
- "type": "string"
- },
- "password": {
- "type": "string",
- "format": "password"
- }
- }
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- }
- },
- "401": {
- "description": "Unauthorized",
- "content": {}
- }
- }
- },
- "delete": {
- "summary": "Close the Session",
- "tags": [
- "Session"
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/session/openid/auth": {
- "get": {
- "summary": "Fetch Session information",
- "tags": [
- "Session"
- ],
- "parameters": [
- {
- }
- ],
- "responses": {
- "303": {
- "description": "Redirect to OpenID Connect identity provider",
- "content": { }
- },
- "404": {
- "description": "OpenID Connect disabled",
- "content": { }
- }
- }
- }
- },
- "/session/openid/callback": {
- "get": {
- "summary": "OpenID Callback",
- "tags": [
- "Session"
- ],
- "parameters": [
- {
- }
- ],
- "responses": {
- "303": {
- "description": "Successful authentication, redirect to homepage",
- "content": { }
- },
- "403": {
- "description": "Invalid callback or negative response from identity provider",
- "content": { }
- },
- "404": {
- "description": "OpenID Connect disabled",
- "content": { }
- },
- "500": {
- "description": "Other OpenID Connect error",
- "content": { }
- }
- }
- }
- },
- "/users": {
- "get": {
- "summary": "Fetch a list of Users",
- "tags": [
- "Users"
- ],
- "parameters": [
- {
- "name": "userId",
- "in": "query",
- "description": "Can only be used by admin or manager users",
- "schema": {
- "type": "string"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/User"
- }
- }
- }
- }
- },
- "400": {
- "description": "No Permission",
- "content": {}
- }
- }
- },
- "post": {
- "summary": "Create a User",
- "tags": [
- "Users"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/users/{id}": {
- "put": {
- "summary": "Update a User",
- "tags": [
- "Users"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a User",
- "tags": [
- "Users"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/notifications": {
- "get": {
- "summary": "Fetch a list of Notifications",
- "description": "Without params, it returns a list of Notifications the user has access to",
- "tags": [
- "Notifications"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Notification",
- "tags": [
- "Notifications"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/notifications/{id}": {
- "put": {
- "summary": "Update a Notification",
- "tags": [
- "Notifications"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Notification",
- "tags": [
- "Notifications"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/notifications/types": {
- "get": {
- "summary": "Fetch a list of available Notification types",
- "tags": [
- "Notifications"
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/NotificationType"
- }
- }
- }
- }
- }
- }
- }
- },
- "/notifications/test": {
- "post": {
- "summary": "Send test notification to current user via Email and SMS",
- "tags": [
- "Notifications"
- ],
- "responses": {
- "204": {
- "description": "Successful sending",
- "content": {}
- },
- "400": {
- "description": "Could happen if sending has failed",
- "content": {}
- }
- }
- }
- },
- "/geofences": {
- "get": {
- "summary": "Fetch a list of Geofences",
- "description": "Without params, it returns a list of Geofences the user has access to",
- "tags": [
- "Geofences"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Geofence",
- "tags": [
- "Geofences"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/geofences/{id}": {
- "put": {
- "summary": "Update a Geofence",
- "tags": [
- "Geofences"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Geofence",
- "tags": [
- "Geofences"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/events/{id}": {
- "get": {
- "tags": [
- "Events"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Event"
- }
- }
- }
- }
- }
- }
- },
- "/reports/route": {
- "get": {
- "summary": "Fetch a list of Positions within the time period for the Devices or Groups",
- "description": "At least one _deviceId_ or one _groupId_ must be passed",
- "tags": [
- "Reports"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Position"
- }
- }
- },
- "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Position"
- }
- }
- }
- }
- }
- }
- }
- },
- "/reports/events": {
- "get": {
- "summary": "Fetch a list of Events within the time period for the Devices or Groups",
- "description": "At least one _deviceId_ or one _groupId_ must be passed",
- "tags": [
- "Reports"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "type",
- "in": "query",
- "description": "% can be used to return events of all types",
- "style": "form",
- "explode": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- }
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Event"
- }
- }
- },
- "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Event"
- }
- }
- }
- }
- }
- }
- }
- },
- "/reports/summary": {
- "get": {
- "summary": "Fetch a list of ReportSummary within the time period for the Devices or Groups",
- "description": "At least one _deviceId_ or one _groupId_ must be passed",
- "tags": [
- "Reports"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportSummary"
- }
- }
- },
- "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportSummary"
- }
- }
- }
- }
- }
- }
- }
- },
- "/reports/trips": {
- "get": {
- "summary": "Fetch a list of ReportTrips within the time period for the Devices or Groups",
- "description": "At least one _deviceId_ or one _groupId_ must be passed",
- "tags": [
- "Reports"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportTrips"
- }
- }
- },
- "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportTrips"
- }
- }
- }
- }
- }
- }
- }
- },
- "/reports/stops": {
- "get": {
- "summary": "Fetch a list of ReportStops within the time period for the Devices or Groups",
- "description": "At least one _deviceId_ or one _groupId_ must be passed",
- "tags": [
- "Reports"
- ],
- "parameters": [
- {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportStops"
- }
- }
- },
- "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/ReportStops"
- }
- }
- }
- }
- }
- }
- }
- },
- "/statistics": {
- "get": {
- "summary": "Fetch server Statistics",
- "tags": [
- "Statistics"
- ],
- "parameters": [
- {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Statistics"
- }
- }
- }
- }
- }
- }
- }
- },
- "/calendars": {
- "get": {
- "summary": "Fetch a list of Calendars",
- "description": "Without params, it returns a list of Calendars the user has access to",
- "tags": [
- "Calendars"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Calendar",
- "tags": [
- "Calendars"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/calendars/{id}": {
- "put": {
- "summary": "Update a Calendar",
- "tags": [
- "Calendars"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Calendar",
- "tags": [
- "Calendars"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/attributes/computed": {
- "get": {
- "summary": "Fetch a list of Attributes",
- "description": "Without params, it returns a list of Attributes the user has access to",
- "tags": [
- "Attributes"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create an Attribute",
- "tags": [
- "Attributes"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/attributes/computed/{id}": {
- "put": {
- "summary": "Update an Attribute",
- "tags": [
- "Attributes"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete an Attribute",
- "tags": [
- "Attributes"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/drivers": {
- "get": {
- "summary": "Fetch a list of Drivers",
- "description": "Without params, it returns a list of Drivers the user has access to",
- "tags": [
- "Drivers"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Driver",
- "tags": [
- "Drivers"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/drivers/{id}": {
- "put": {
- "summary": "Update a Driver",
- "tags": [
- "Drivers"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Driver",
- "tags": [
- "Drivers"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- },
- "/maintenance": {
- "get": {
- "summary": "Fetch a list of Maintenance",
- "description": "Without params, it returns a list of Maintenance the user has access to",
- "tags": [
- "Maintenance"
- ],
- "parameters": [
- {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- }
- ],
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "type": "array",
- "items": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- }
- }
- }
- }
- },
- "post": {
- "summary": "Create a Maintenance",
- "tags": [
- "Maintenance"
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- }
- },
- "/maintenance/{id}": {
- "put": {
- "summary": "Update a Maintenance",
- "tags": [
- "Maintenance"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "requestBody": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- },
- "required": true
- },
- "responses": {
- "200": {
- "description": "OK",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- }
- }
- },
- "x-codegen-request-body-name": "body"
- },
- "delete": {
- "summary": "Delete a Maintenance",
- "tags": [
- "Maintenance"
- ],
- "parameters": [
- {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- }
- ],
- "responses": {
- "204": {
- "description": "No Content",
- "content": {}
- }
- }
- }
- }
- },
- "components": {
- "schemas": {
- "Position": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "deviceId": {
- "type": "integer"
- },
- "protocol": {
- "type": "string"
- },
- "deviceTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "fixTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "serverTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "outdated": {
- "type": "boolean"
- },
- "valid": {
- "type": "boolean"
- },
- "latitude": {
- "type": "number"
- },
- "longitude": {
- "type": "number"
- },
- "altitude": {
- "type": "number"
- },
- "speed": {
- "type": "number",
- "description": "in knots"
- },
- "course": {
- "type": "number"
- },
- "address": {
- "type": "string"
- },
- "accuracy": {
- "type": "number"
- },
- "network": {
- "type": "object",
- "properties": {}
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "User": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "email": {
- "type": "string"
- },
- "phone": {
- "type": "string"
- },
- "readonly": {
- "type": "boolean"
- },
- "administrator": {
- "type": "boolean"
- },
- "map": {
- "type": "string"
- },
- "latitude": {
- "type": "number"
- },
- "longitude": {
- "type": "number"
- },
- "zoom": {
- "type": "integer"
- },
- "password": {
- "type": "string"
- },
- "twelveHourFormat": {
- "type": "boolean"
- },
- "coordinateFormat": {
- "type": "string"
- },
- "disabled": {
- "type": "boolean"
- },
- "expirationTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "deviceLimit": {
- "type": "integer"
- },
- "userLimit": {
- "type": "integer"
- },
- "deviceReadonly": {
- "type": "boolean"
- },
- "limitCommands": {
- "type": "boolean"
- },
- "poiLayer": {
- "type": "string"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Server": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "registration": {
- "type": "boolean"
- },
- "readonly": {
- "type": "boolean"
- },
- "deviceReadonly": {
- "type": "boolean"
- },
- "limitCommands": {
- "type": "boolean"
- },
- "map": {
- "type": "string"
- },
- "bingKey": {
- "type": "string"
- },
- "mapUrl": {
- "type": "string"
- },
- "poiLayer": {
- "type": "string"
- },
- "latitude": {
- "type": "number"
- },
- "longitude": {
- "type": "number"
- },
- "zoom": {
- "type": "integer"
- },
- "twelveHourFormat": {
- "type": "boolean"
- },
- "version": {
- "type": "string"
- },
- "forceSettings": {
- "type": "boolean"
- },
- "coordinateFormat": {
- "type": "string"
- },
- "oidcEnabled": {
- "type": "boolean"
- },
- "oidcForce": {
- "type": "boolean"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Command": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "deviceId": {
- "type": "integer"
- },
- "description": {
- "type": "string"
- },
- "type": {
- "type": "string"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Device": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "uniqueId": {
- "type": "string"
- },
- "status": {
- "type": "string"
- },
- "disabled": {
- "type": "boolean"
- },
- "lastUpdate": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "positionId": {
- "type": "integer"
- },
- "groupId": {
- "type": "integer"
- },
- "phone": {
- "type": "string"
- },
- "model": {
- "type": "string"
- },
- "contact": {
- "type": "string"
- },
- "category": {
- "type": "string"
- },
- "geofenceIds": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Group": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "groupId": {
- "type": "integer"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Permission": {
- "type": "object",
- "properties": {
- "userId": {
- "type": "integer",
- "description": "User Id, can be only first parameter"
- },
- "deviceId": {
- "type": "integer",
- "description": "Device Id, can be first parameter or second only in combination with userId"
- },
- "groupId": {
- "type": "integer",
- "description": "Group Id, can be first parameter or second only in combination with userId"
- },
- "geofenceId": {
- "type": "integer",
- "description": "Geofence Id, can be second parameter only"
- },
- "notificationId": {
- "type": "integer",
- "description": "Notification Id, can be second parameter only"
- },
- "calendarId": {
- "type": "integer",
- "description": "Calendar Id, can be second parameter only and only in combination with userId"
- },
- "attributeId": {
- "type": "integer",
- "description": "Computed Attribute Id, can be second parameter only"
- },
- "driverId": {
- "type": "integer",
- "description": "Driver Id, can be second parameter only"
- },
- "managedUserId": {
- "type": "integer",
- "description": "User Id, can be second parameter only and only in combination with userId"
- }
- },
- "description": "This is a permission map that contain two object indexes. It is used to link/unlink objects. Order is important. Example: { deviceId:8, geofenceId: 16 }"
- },
- "CommandType": {
- "type": "object",
- "properties": {
- "type": {
- "type": "string"
- }
- }
- },
- "Geofence": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "description": {
- "type": "string"
- },
- "area": {
- "type": "string"
- },
- "calendarId": {
- "type": "integer"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Notification": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "type": {
- "type": "string"
- },
- "always": {
- "type": "boolean"
- },
- "web": {
- "type": "boolean"
- },
- "mail": {
- "type": "boolean"
- },
- "sms": {
- "type": "boolean"
- },
- "calendarId": {
- "type": "integer"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "NotificationType": {
- "type": "object",
- "properties": {
- "type": {
- "type": "string"
- }
- }
- },
- "Event": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "type": {
- "type": "string"
- },
- "eventTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "deviceId": {
- "type": "integer"
- },
- "positionId": {
- "type": "integer"
- },
- "geofenceId": {
- "type": "integer"
- },
- "maintenanceId": {
- "type": "integer"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "ReportSummary": {
- "type": "object",
- "properties": {
- "deviceId": {
- "type": "integer"
- },
- "deviceName": {
- "type": "string"
- },
- "maxSpeed": {
- "type": "number",
- "description": "in knots"
- },
- "averageSpeed": {
- "type": "number",
- "description": "in knots"
- },
- "distance": {
- "type": "number",
- "description": "in meters"
- },
- "spentFuel": {
- "type": "number",
- "description": "in liters"
- },
- "engineHours": {
- "type": "integer"
- }
- }
- },
- "ReportTrips": {
- "type": "object",
- "properties": {
- "deviceId": {
- "type": "integer"
- },
- "deviceName": {
- "type": "string"
- },
- "maxSpeed": {
- "type": "number",
- "description": "in knots"
- },
- "averageSpeed": {
- "type": "number",
- "description": "in knots"
- },
- "distance": {
- "type": "number",
- "description": "in meters"
- },
- "spentFuel": {
- "type": "number",
- "description": "in liters"
- },
- "duration": {
- "type": "integer"
- },
- "startTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "startAddress": {
- "type": "string"
- },
- "startLat": {
- "type": "number"
- },
- "startLon": {
- "type": "number"
- },
- "endTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "endAddress": {
- "type": "string"
- },
- "endLat": {
- "type": "number"
- },
- "endLon": {
- "type": "number"
- },
- "driverUniqueId": {
- "type": "integer"
- },
- "driverName": {
- "type": "string"
- }
- }
- },
- "ReportStops": {
- "type": "object",
- "properties": {
- "deviceId": {
- "type": "integer"
- },
- "deviceName": {
- "type": "string"
- },
- "duration": {
- "type": "integer"
- },
- "startTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "address": {
- "type": "string"
- },
- "lat": {
- "type": "number"
- },
- "lon": {
- "type": "number"
- },
- "endTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "spentFuel": {
- "type": "number",
- "description": "in liters"
- },
- "engineHours": {
- "type": "integer"
- }
- }
- },
- "Statistics": {
- "type": "object",
- "properties": {
- "captureTime": {
- "type": "string",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "format": "date-time"
- },
- "activeUsers": {
- "type": "integer"
- },
- "activeDevices": {
- "type": "integer"
- },
- "requests": {
- "type": "integer"
- },
- "messagesReceived": {
- "type": "integer"
- },
- "messagesStored": {
- "type": "integer"
- }
- }
- },
- "DeviceAccumulators": {
- "type": "object",
- "properties": {
- "deviceId": {
- "type": "integer"
- },
- "totalDistance": {
- "type": "number",
- "description": "in meters"
- },
- "hours": {
- "type": "number"
- }
- }
- },
- "Calendar": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "data": {
- "type": "string",
- "description": "base64 encoded in iCalendar format"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Attribute": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "description": {
- "type": "string"
- },
- "attribute": {
- "type": "string"
- },
- "expression": {
- "type": "string"
- },
- "type": {
- "type": "string",
- "description": "String|Number|Boolean"
- }
- }
- },
- "Driver": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "uniqueId": {
- "type": "string"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- },
- "Maintenance": {
- "type": "object",
- "properties": {
- "id": {
- "type": "integer"
- },
- "name": {
- "type": "string"
- },
- "type": {
- "type": "string"
- },
- "start": {
- "type": "number"
- },
- "period": {
- "type": "number"
- },
- "attributes": {
- "type": "object",
- "properties": {}
- }
- }
- }
- },
- "parameters": {
- "entityId": {
- "name": "id",
- "in": "path",
- "required": true,
- "schema": {
- "type": "integer"
- }
- },
- "all": {
- "name": "all",
- "in": "query",
- "description": "Can only be used by admins or managers to fetch all entities",
- "schema": {
- "type": "boolean"
- }
- },
- "refresh": {
- "name": "refresh",
- "in": "query",
- "schema": {
- "type": "boolean"
- }
- },
- "userId": {
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this only with their own _userId_",
- "schema": {
- "type": "integer"
- }
- },
- "deviceId": {
- "name": "deviceId",
- "in": "query",
- "description": "Standard users can use this only with _deviceId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- "groupId": {
- "name": "groupId",
- "in": "query",
- "description": "Standard users can use this only with _groupId_s, they have access to",
- "schema": {
- "type": "integer"
- }
- },
- "deviceIdArray": {
- "name": "deviceId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- "groupIdArray": {
- "name": "groupId",
- "in": "query",
- "style": "form",
- "explode": true,
- "schema": {
- "type": "array",
- "items": {
- "type": "integer"
- }
- }
- },
- "fromTime": {
- "name": "from",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- },
- "toTime": {
- "name": "to",
- "in": "query",
- "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
- "required": true,
- "schema": {
- "type": "string",
- "format": "date-time"
- }
- }
- },
- "requestBodies": {
- "Device": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Device"
- }
- }
- },
- "required": true
- },
- "Permission": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Permission"
- }
- }
- },
- "required": true
- },
- "Group": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Group"
- }
- }
- },
- "required": true
- },
- "User": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/User"
- }
- }
- },
- "required": true
- },
- "Geofence": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Geofence"
- }
- }
- },
- "required": true
- },
- "Calendar": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Calendar"
- }
- }
- },
- "required": true
- },
- "Attribute": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Attribute"
- }
- }
- },
- "required": true
- },
- "Driver": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Driver"
- }
- }
- },
- "required": true
- },
- "Command": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Command"
- }
- }
- },
- "required": true
- },
- "Notification": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Notification"
- }
- }
- },
- "required": true
- },
- "Maintenance": {
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Maintenance"
- }
- }
- },
- "required": true
- }
- },
- "securitySchemes": {
- "basicAuth": {
- "type": "http",
- "description": "Basic HTTP authorization with _email_ and _password_",
- "scheme": "basic"
- }
- }
- }
-}
+{
+ "openapi": "3.0.1",
+ "info": {
+ "title": "Traccar",
+ "version": "5.6",
+ "description": "Traccar GPS tracking server API documentation. To use the API you need to have a server instance. For testing purposes you can use one of free [demo servers](https://www.traccar.org/demo-server/). For production use you can install your own server or get a [subscription service](https://www.traccar.org/product/tracking-server/).",
+ "contact": {
+ "name": "Traccar Support",
+ "url": "https://www.traccar.org/",
+ "email": "support@traccar.org"
+ },
+ "license": {
+ "name": "Apache 2.0",
+ "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
+ }
+ },
+ "servers": [
+ {
+ "url": "https://demo.traccar.org/api",
+ "description": "Demo Server 1"
+ },
+ {
+ "url": "https://demo2.traccar.org/api",
+ "description": "Demo Server 2"
+ },
+ {
+ "url": "https://demo3.traccar.org/api",
+ "description": "Demo Server 3"
+ },
+ {
+ "url": "https://demo4.traccar.org/api",
+ "description": "Demo Server 4"
+ },
+ {
+ "url": "https://server.traccar.org/api",
+ "description": "Subscription Server"
+ },
+ {
+ "url": "http://{host}:{port}/api",
+ "description": "Other Server",
+ "variables": {
+ "host": {
+ "default": "localhost"
+ },
+ "port": {
+ "enum": [
+ "8082",
+ "80"
+ ],
+ "default": "8082"
+ }
+ }
+ }
+ ],
+ "security": [
+ {
+ "basicAuth": []
+ }
+ ],
+ "tags": [
+ {
+ "name": "Server",
+ "description": "Server information"
+ },
+ {
+ "name": "Session",
+ "description": "User session management"
+ },
+ {
+ "name": "Devices",
+ "description": "Device management"
+ },
+ {
+ "name": "Groups",
+ "description": "Group management"
+ },
+ {
+ "name": "Users",
+ "description": "User management"
+ },
+ {
+ "name": "Permissions",
+ "description": "User permissions and other object linking"
+ },
+ {
+ "name": "Positions",
+ "description": "Retrieving raw location information"
+ },
+ {
+ "name": "Events",
+ "description": "Retrieving event information"
+ },
+ {
+ "name": "Reports",
+ "description": "Reports generation"
+ },
+ {
+ "name": "Notifications",
+ "description": "User notifications management"
+ },
+ {
+ "name": "Geofences",
+ "description": "Geofence management"
+ },
+ {
+ "name": "Commands",
+ "description": "Sending commands to devices and stored command management"
+ },
+ {
+ "name": "Attributes",
+ "description": "Computed attributes management"
+ },
+ {
+ "name": "Drivers",
+ "description": "Drivers management"
+ },
+ {
+ "name": "Maintenance",
+ "description": "Maintenance management"
+ },
+ {
+ "name": "Calendars",
+ "description": "Calendar management"
+ },
+ {
+ "name": "Statistics",
+ "description": "Retrieving server statistics"
+ }
+ ],
+ "paths": {
+ "/commands": {
+ "get": {
+ "summary": "Fetch a list of Saved Commands",
+ "tags": [
+ "Commands"
+ ],
+ "description": "Without params, it returns a list of Saved Commands the user has access to",
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Saved Command",
+ "tags": [
+ "Commands"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/commands/{id}": {
+ "put": {
+ "summary": "Update a Saved Command",
+ "tags": [
+ "Commands"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Saved Command",
+ "tags": [
+ "Commands"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/commands/send": {
+ "get": {
+ "summary": "Fetch a list of Saved Commands supported by Device at the moment",
+ "description": "Return a list of saved commands linked to Device and its groups, filtered by current Device protocol support",
+ "tags": [
+ "Commands"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "Could happen when the user doesn't have permission for the device",
+ "content": {}
+ }
+ }
+ },
+ "post": {
+ "summary": "Dispatch commands to device",
+ "description": "Dispatch a new command or Saved Command if _body.id_ set",
+ "tags": [
+ "Commands"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "Command sent",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ },
+ "202": {
+ "description": "Command queued",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "Could happen when the user doesn't have permission or an incorrect command _type_ for the device",
+ "content": {}
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/commands/types": {
+ "get": {
+ "summary": "Fetch a list of available Commands for the Device or all possible Commands if Device ommited",
+ "tags": [
+ "Commands"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Internal device identifier. Only works if device has already reported some locations",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "protocol",
+ "in": "query",
+ "description": "Protocol name. Can be used instead of device id",
+ "schema": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "textChannel",
+ "in": "query",
+ "description": "When `true` return SMS commands. If not specified or `false` return data commands",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/CommandType"
+ }
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "Could happen when trying to fetch from a device the user does not have permission",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/devices": {
+ "get": {
+ "summary": "Fetch a list of Devices",
+ "description": "Without any params, returns a list of the user's devices",
+ "tags": [
+ "Devices"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "id",
+ "in": "query",
+ "description": "To fetch one or more devices. Multiple params can be passed like `id=31&id=42`",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "uniqueId",
+ "in": "query",
+ "description": "To fetch one or more devices. Multiple params can be passed like `uniqueId=333331&uniqieId=44442`",
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "No permission",
+ "content": {}
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Device",
+ "tags": [
+ "Devices"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/devices/{id}": {
+ "put": {
+ "summary": "Update a Device",
+ "tags": [
+ "Devices"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Device",
+ "tags": [
+ "Devices"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/devices/{id}/accumulators": {
+ "put": {
+ "summary": "Update total distance and hours of the Device",
+ "tags": [
+ "Devices"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/DeviceAccumulators"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/groups": {
+ "get": {
+ "summary": "Fetch a list of Groups",
+ "description": "Without any params, returns a list of the Groups the user belongs to",
+ "tags": [
+ "Groups"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Group",
+ "tags": [
+ "Groups"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "No permission",
+ "content": {}
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/groups/{id}": {
+ "put": {
+ "summary": "Update a Group",
+ "tags": [
+ "Groups"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Group",
+ "tags": [
+ "Groups"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/permissions": {
+ "post": {
+ "summary": "Link an Object to another Object",
+ "tags": [
+ "Permissions"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Permission"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ },
+ "400": {
+ "description": "No permission",
+ "content": {}
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Unlink an Object from another Object",
+ "tags": [
+ "Permissions"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Permission"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/positions": {
+ "get": {
+ "summary": "Fetches a list of Positions",
+ "description": "We strongly recommend using [Traccar WebSocket API](https://www.traccar.org/traccar-api/) instead of periodically polling positions endpoint. Without any params, it returns a list of last known positions for all the user's Devices. _from_ and _to_ fields are not required with _id_.",
+ "tags": [
+ "Positions"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "_deviceId_ is optional, but requires the _from_ and _to_ parameters when used",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "id",
+ "in": "query",
+ "description": "To fetch one or more positions. Multiple params can be passed like `id=31&id=42`",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Position"
+ }
+ }
+ },
+ "text/csv": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Position"
+ }
+ }
+ },
+ "application/gpx+xml": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Position"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/server": {
+ "get": {
+ "summary": "Fetch Server information",
+ "tags": [
+ "Server"
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Server"
+ }
+ }
+ }
+ }
+ }
+ },
+ "put": {
+ "summary": "Update Server information",
+ "tags": [
+ "Server"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Server"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Server"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/session": {
+ "get": {
+ "summary": "Fetch Session information",
+ "tags": [
+ "Session"
+ ],
+ "parameters": [
+ {
+ "name": "token",
+ "in": "query",
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ }
+ },
+ "404": {
+ "description": "Not Found",
+ "content": {}
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a new Session",
+ "tags": [
+ "Session"
+ ],
+ "requestBody": {
+ "content": {
+ "application/x-www-form-urlencoded": {
+ "schema": {
+ "required": [
+ "email",
+ "password"
+ ],
+ "properties": {
+ "email": {
+ "type": "string"
+ },
+ "password": {
+ "type": "string",
+ "format": "password"
+ }
+ }
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ }
+ },
+ "401": {
+ "description": "Unauthorized",
+ "content": {}
+ }
+ }
+ },
+ "delete": {
+ "summary": "Close the Session",
+ "tags": [
+ "Session"
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/session/openid/auth": {
+ "get": {
+ "summary": "Fetch Session information",
+ "tags": [
+ "Session"
+ ],
+ "parameters": [
+ {
+ }
+ ],
+ "responses": {
+ "303": {
+ "description": "Redirect to OpenID Connect identity provider",
+ "content": { }
+ }
+ }
+ }
+ },
+ "/session/openid/callback": {
+ "get": {
+ "summary": "OpenID Callback",
+ "tags": [
+ "Session"
+ ],
+ "parameters": [
+ {
+ }
+ ],
+ "responses": {
+ "303": {
+ "description": "Successful authentication, redirect to homepage",
+ "content": { }
+ }
+ }
+ }
+ },
+ "/users": {
+ "get": {
+ "summary": "Fetch a list of Users",
+ "tags": [
+ "Users"
+ ],
+ "parameters": [
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Can only be used by admin or manager users",
+ "schema": {
+ "type": "string"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ }
+ }
+ },
+ "400": {
+ "description": "No Permission",
+ "content": {}
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a User",
+ "tags": [
+ "Users"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/users/{id}": {
+ "put": {
+ "summary": "Update a User",
+ "tags": [
+ "Users"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a User",
+ "tags": [
+ "Users"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/notifications": {
+ "get": {
+ "summary": "Fetch a list of Notifications",
+ "description": "Without params, it returns a list of Notifications the user has access to",
+ "tags": [
+ "Notifications"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Notification",
+ "tags": [
+ "Notifications"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/notifications/{id}": {
+ "put": {
+ "summary": "Update a Notification",
+ "tags": [
+ "Notifications"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Notification",
+ "tags": [
+ "Notifications"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/notifications/types": {
+ "get": {
+ "summary": "Fetch a list of available Notification types",
+ "tags": [
+ "Notifications"
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NotificationType"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/notifications/test": {
+ "post": {
+ "summary": "Send test notification to current user via Email and SMS",
+ "tags": [
+ "Notifications"
+ ],
+ "responses": {
+ "204": {
+ "description": "Successful sending",
+ "content": {}
+ },
+ "400": {
+ "description": "Could happen if sending has failed",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/geofences": {
+ "get": {
+ "summary": "Fetch a list of Geofences",
+ "description": "Without params, it returns a list of Geofences the user has access to",
+ "tags": [
+ "Geofences"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Geofence",
+ "tags": [
+ "Geofences"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/geofences/{id}": {
+ "put": {
+ "summary": "Update a Geofence",
+ "tags": [
+ "Geofences"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Geofence",
+ "tags": [
+ "Geofences"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/events/{id}": {
+ "get": {
+ "tags": [
+ "Events"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Event"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/reports/route": {
+ "get": {
+ "summary": "Fetch a list of Positions within the time period for the Devices or Groups",
+ "description": "At least one _deviceId_ or one _groupId_ must be passed",
+ "tags": [
+ "Reports"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Position"
+ }
+ }
+ },
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Position"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/reports/events": {
+ "get": {
+ "summary": "Fetch a list of Events within the time period for the Devices or Groups",
+ "description": "At least one _deviceId_ or one _groupId_ must be passed",
+ "tags": [
+ "Reports"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "type",
+ "in": "query",
+ "description": "% can be used to return events of all types",
+ "style": "form",
+ "explode": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Event"
+ }
+ }
+ },
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Event"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/reports/summary": {
+ "get": {
+ "summary": "Fetch a list of ReportSummary within the time period for the Devices or Groups",
+ "description": "At least one _deviceId_ or one _groupId_ must be passed",
+ "tags": [
+ "Reports"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportSummary"
+ }
+ }
+ },
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportSummary"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/reports/trips": {
+ "get": {
+ "summary": "Fetch a list of ReportTrips within the time period for the Devices or Groups",
+ "description": "At least one _deviceId_ or one _groupId_ must be passed",
+ "tags": [
+ "Reports"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportTrips"
+ }
+ }
+ },
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportTrips"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/reports/stops": {
+ "get": {
+ "summary": "Fetch a list of ReportStops within the time period for the Devices or Groups",
+ "description": "At least one _deviceId_ or one _groupId_ must be passed",
+ "tags": [
+ "Reports"
+ ],
+ "parameters": [
+ {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportStops"
+ }
+ }
+ },
+ "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ReportStops"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/statistics": {
+ "get": {
+ "summary": "Fetch server Statistics",
+ "tags": [
+ "Statistics"
+ ],
+ "parameters": [
+ {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Statistics"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "/calendars": {
+ "get": {
+ "summary": "Fetch a list of Calendars",
+ "description": "Without params, it returns a list of Calendars the user has access to",
+ "tags": [
+ "Calendars"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Calendar",
+ "tags": [
+ "Calendars"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/calendars/{id}": {
+ "put": {
+ "summary": "Update a Calendar",
+ "tags": [
+ "Calendars"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Calendar",
+ "tags": [
+ "Calendars"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/attributes/computed": {
+ "get": {
+ "summary": "Fetch a list of Attributes",
+ "description": "Without params, it returns a list of Attributes the user has access to",
+ "tags": [
+ "Attributes"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create an Attribute",
+ "tags": [
+ "Attributes"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/attributes/computed/{id}": {
+ "put": {
+ "summary": "Update an Attribute",
+ "tags": [
+ "Attributes"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete an Attribute",
+ "tags": [
+ "Attributes"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/drivers": {
+ "get": {
+ "summary": "Fetch a list of Drivers",
+ "description": "Without params, it returns a list of Drivers the user has access to",
+ "tags": [
+ "Drivers"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Driver",
+ "tags": [
+ "Drivers"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/drivers/{id}": {
+ "put": {
+ "summary": "Update a Driver",
+ "tags": [
+ "Drivers"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Driver",
+ "tags": [
+ "Drivers"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ },
+ "/maintenance": {
+ "get": {
+ "summary": "Fetch a list of Maintenance",
+ "description": "Without params, it returns a list of Maintenance the user has access to",
+ "tags": [
+ "Maintenance"
+ ],
+ "parameters": [
+ {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "post": {
+ "summary": "Create a Maintenance",
+ "tags": [
+ "Maintenance"
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ }
+ },
+ "/maintenance/{id}": {
+ "put": {
+ "summary": "Update a Maintenance",
+ "tags": [
+ "Maintenance"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ },
+ "required": true
+ },
+ "responses": {
+ "200": {
+ "description": "OK",
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ }
+ }
+ },
+ "x-codegen-request-body-name": "body"
+ },
+ "delete": {
+ "summary": "Delete a Maintenance",
+ "tags": [
+ "Maintenance"
+ ],
+ "parameters": [
+ {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ }
+ ],
+ "responses": {
+ "204": {
+ "description": "No Content",
+ "content": {}
+ }
+ }
+ }
+ }
+ },
+ "components": {
+ "schemas": {
+ "Position": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "deviceId": {
+ "type": "integer"
+ },
+ "protocol": {
+ "type": "string"
+ },
+ "deviceTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "fixTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "serverTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "outdated": {
+ "type": "boolean"
+ },
+ "valid": {
+ "type": "boolean"
+ },
+ "latitude": {
+ "type": "number"
+ },
+ "longitude": {
+ "type": "number"
+ },
+ "altitude": {
+ "type": "number"
+ },
+ "speed": {
+ "type": "number",
+ "description": "in knots"
+ },
+ "course": {
+ "type": "number"
+ },
+ "address": {
+ "type": "string"
+ },
+ "accuracy": {
+ "type": "number"
+ },
+ "network": {
+ "type": "object",
+ "properties": {}
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "User": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "email": {
+ "type": "string"
+ },
+ "phone": {
+ "type": "string"
+ },
+ "readonly": {
+ "type": "boolean"
+ },
+ "administrator": {
+ "type": "boolean"
+ },
+ "map": {
+ "type": "string"
+ },
+ "latitude": {
+ "type": "number"
+ },
+ "longitude": {
+ "type": "number"
+ },
+ "zoom": {
+ "type": "integer"
+ },
+ "password": {
+ "type": "string"
+ },
+ "twelveHourFormat": {
+ "type": "boolean"
+ },
+ "coordinateFormat": {
+ "type": "string"
+ },
+ "disabled": {
+ "type": "boolean"
+ },
+ "expirationTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "deviceLimit": {
+ "type": "integer"
+ },
+ "userLimit": {
+ "type": "integer"
+ },
+ "deviceReadonly": {
+ "type": "boolean"
+ },
+ "limitCommands": {
+ "type": "boolean"
+ },
+ "poiLayer": {
+ "type": "string"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Server": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "registration": {
+ "type": "boolean"
+ },
+ "readonly": {
+ "type": "boolean"
+ },
+ "deviceReadonly": {
+ "type": "boolean"
+ },
+ "limitCommands": {
+ "type": "boolean"
+ },
+ "map": {
+ "type": "string"
+ },
+ "bingKey": {
+ "type": "string"
+ },
+ "mapUrl": {
+ "type": "string"
+ },
+ "poiLayer": {
+ "type": "string"
+ },
+ "latitude": {
+ "type": "number"
+ },
+ "longitude": {
+ "type": "number"
+ },
+ "zoom": {
+ "type": "integer"
+ },
+ "twelveHourFormat": {
+ "type": "boolean"
+ },
+ "version": {
+ "type": "string"
+ },
+ "forceSettings": {
+ "type": "boolean"
+ },
+ "coordinateFormat": {
+ "type": "string"
+ },
+ "openIdEnabled": {
+ "type": "boolean"
+ },
+ "openIdForce": {
+ "type": "boolean"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Command": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "deviceId": {
+ "type": "integer"
+ },
+ "description": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Device": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "uniqueId": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ },
+ "disabled": {
+ "type": "boolean"
+ },
+ "lastUpdate": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "positionId": {
+ "type": "integer"
+ },
+ "groupId": {
+ "type": "integer"
+ },
+ "phone": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "contact": {
+ "type": "string"
+ },
+ "category": {
+ "type": "string"
+ },
+ "geofenceIds": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Group": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "groupId": {
+ "type": "integer"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Permission": {
+ "type": "object",
+ "properties": {
+ "userId": {
+ "type": "integer",
+ "description": "User Id, can be only first parameter"
+ },
+ "deviceId": {
+ "type": "integer",
+ "description": "Device Id, can be first parameter or second only in combination with userId"
+ },
+ "groupId": {
+ "type": "integer",
+ "description": "Group Id, can be first parameter or second only in combination with userId"
+ },
+ "geofenceId": {
+ "type": "integer",
+ "description": "Geofence Id, can be second parameter only"
+ },
+ "notificationId": {
+ "type": "integer",
+ "description": "Notification Id, can be second parameter only"
+ },
+ "calendarId": {
+ "type": "integer",
+ "description": "Calendar Id, can be second parameter only and only in combination with userId"
+ },
+ "attributeId": {
+ "type": "integer",
+ "description": "Computed Attribute Id, can be second parameter only"
+ },
+ "driverId": {
+ "type": "integer",
+ "description": "Driver Id, can be second parameter only"
+ },
+ "managedUserId": {
+ "type": "integer",
+ "description": "User Id, can be second parameter only and only in combination with userId"
+ }
+ },
+ "description": "This is a permission map that contain two object indexes. It is used to link/unlink objects. Order is important. Example: { deviceId:8, geofenceId: 16 }"
+ },
+ "CommandType": {
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ }
+ }
+ },
+ "Geofence": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "description": {
+ "type": "string"
+ },
+ "area": {
+ "type": "string"
+ },
+ "calendarId": {
+ "type": "integer"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Notification": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "type": {
+ "type": "string"
+ },
+ "always": {
+ "type": "boolean"
+ },
+ "web": {
+ "type": "boolean"
+ },
+ "mail": {
+ "type": "boolean"
+ },
+ "sms": {
+ "type": "boolean"
+ },
+ "calendarId": {
+ "type": "integer"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "NotificationType": {
+ "type": "object",
+ "properties": {
+ "type": {
+ "type": "string"
+ }
+ }
+ },
+ "Event": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "type": {
+ "type": "string"
+ },
+ "eventTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "deviceId": {
+ "type": "integer"
+ },
+ "positionId": {
+ "type": "integer"
+ },
+ "geofenceId": {
+ "type": "integer"
+ },
+ "maintenanceId": {
+ "type": "integer"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "ReportSummary": {
+ "type": "object",
+ "properties": {
+ "deviceId": {
+ "type": "integer"
+ },
+ "deviceName": {
+ "type": "string"
+ },
+ "maxSpeed": {
+ "type": "number",
+ "description": "in knots"
+ },
+ "averageSpeed": {
+ "type": "number",
+ "description": "in knots"
+ },
+ "distance": {
+ "type": "number",
+ "description": "in meters"
+ },
+ "spentFuel": {
+ "type": "number",
+ "description": "in liters"
+ },
+ "engineHours": {
+ "type": "integer"
+ }
+ }
+ },
+ "ReportTrips": {
+ "type": "object",
+ "properties": {
+ "deviceId": {
+ "type": "integer"
+ },
+ "deviceName": {
+ "type": "string"
+ },
+ "maxSpeed": {
+ "type": "number",
+ "description": "in knots"
+ },
+ "averageSpeed": {
+ "type": "number",
+ "description": "in knots"
+ },
+ "distance": {
+ "type": "number",
+ "description": "in meters"
+ },
+ "spentFuel": {
+ "type": "number",
+ "description": "in liters"
+ },
+ "duration": {
+ "type": "integer"
+ },
+ "startTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "startAddress": {
+ "type": "string"
+ },
+ "startLat": {
+ "type": "number"
+ },
+ "startLon": {
+ "type": "number"
+ },
+ "endTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "endAddress": {
+ "type": "string"
+ },
+ "endLat": {
+ "type": "number"
+ },
+ "endLon": {
+ "type": "number"
+ },
+ "driverUniqueId": {
+ "type": "integer"
+ },
+ "driverName": {
+ "type": "string"
+ }
+ }
+ },
+ "ReportStops": {
+ "type": "object",
+ "properties": {
+ "deviceId": {
+ "type": "integer"
+ },
+ "deviceName": {
+ "type": "string"
+ },
+ "duration": {
+ "type": "integer"
+ },
+ "startTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "address": {
+ "type": "string"
+ },
+ "lat": {
+ "type": "number"
+ },
+ "lon": {
+ "type": "number"
+ },
+ "endTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "spentFuel": {
+ "type": "number",
+ "description": "in liters"
+ },
+ "engineHours": {
+ "type": "integer"
+ }
+ }
+ },
+ "Statistics": {
+ "type": "object",
+ "properties": {
+ "captureTime": {
+ "type": "string",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "format": "date-time"
+ },
+ "activeUsers": {
+ "type": "integer"
+ },
+ "activeDevices": {
+ "type": "integer"
+ },
+ "requests": {
+ "type": "integer"
+ },
+ "messagesReceived": {
+ "type": "integer"
+ },
+ "messagesStored": {
+ "type": "integer"
+ }
+ }
+ },
+ "DeviceAccumulators": {
+ "type": "object",
+ "properties": {
+ "deviceId": {
+ "type": "integer"
+ },
+ "totalDistance": {
+ "type": "number",
+ "description": "in meters"
+ },
+ "hours": {
+ "type": "number"
+ }
+ }
+ },
+ "Calendar": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "data": {
+ "type": "string",
+ "description": "base64 encoded in iCalendar format"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Attribute": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "description": {
+ "type": "string"
+ },
+ "attribute": {
+ "type": "string"
+ },
+ "expression": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string",
+ "description": "String|Number|Boolean"
+ }
+ }
+ },
+ "Driver": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "uniqueId": {
+ "type": "string"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ },
+ "Maintenance": {
+ "type": "object",
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ },
+ "start": {
+ "type": "number"
+ },
+ "period": {
+ "type": "number"
+ },
+ "attributes": {
+ "type": "object",
+ "properties": {}
+ }
+ }
+ }
+ },
+ "parameters": {
+ "entityId": {
+ "name": "id",
+ "in": "path",
+ "required": true,
+ "schema": {
+ "type": "integer"
+ }
+ },
+ "all": {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admins or managers to fetch all entities",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ "refresh": {
+ "name": "refresh",
+ "in": "query",
+ "schema": {
+ "type": "boolean"
+ }
+ },
+ "userId": {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this only with their own _userId_",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ "deviceId": {
+ "name": "deviceId",
+ "in": "query",
+ "description": "Standard users can use this only with _deviceId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ "groupId": {
+ "name": "groupId",
+ "in": "query",
+ "description": "Standard users can use this only with _groupId_s, they have access to",
+ "schema": {
+ "type": "integer"
+ }
+ },
+ "deviceIdArray": {
+ "name": "deviceId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ "groupIdArray": {
+ "name": "groupId",
+ "in": "query",
+ "style": "form",
+ "explode": true,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ "fromTime": {
+ "name": "from",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ },
+ "toTime": {
+ "name": "to",
+ "in": "query",
+ "description": "in IS0 8601 format. eg. `1963-11-22T18:30:00Z`",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "format": "date-time"
+ }
+ }
+ },
+ "requestBodies": {
+ "Device": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Device"
+ }
+ }
+ },
+ "required": true
+ },
+ "Permission": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Permission"
+ }
+ }
+ },
+ "required": true
+ },
+ "Group": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Group"
+ }
+ }
+ },
+ "required": true
+ },
+ "User": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/User"
+ }
+ }
+ },
+ "required": true
+ },
+ "Geofence": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Geofence"
+ }
+ }
+ },
+ "required": true
+ },
+ "Calendar": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Calendar"
+ }
+ }
+ },
+ "required": true
+ },
+ "Attribute": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Attribute"
+ }
+ }
+ },
+ "required": true
+ },
+ "Driver": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Driver"
+ }
+ }
+ },
+ "required": true
+ },
+ "Command": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Command"
+ }
+ }
+ },
+ "required": true
+ },
+ "Notification": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Notification"
+ }
+ }
+ },
+ "required": true
+ },
+ "Maintenance": {
+ "content": {
+ "application/json": {
+ "schema": {
+ "$ref": "#/components/schemas/Maintenance"
+ }
+ }
+ },
+ "required": true
+ }
+ },
+ "securitySchemes": {
+ "basicAuth": {
+ "type": "http",
+ "description": "Basic HTTP authorization with _email_ and _password_",
+ "scheme": "basic"
+ }
+ }
+ }
+}