Objects service
Service version: 1
Last edit: 2019.09.18
Purpose
The Location History API Objects service provides a client-side reporting device position (a person, drone, vehicle, etc.).
It is defined on the customer side by an Admin.
An Object has the following characteristics.
- It is uniquely identifiable.
- It can only be linked to a single Configuration at a time.
- It has a certain connectivity capability.
- It has a position.
- It may also have other user-defined properties.
To query the service, an Object only requires an API Key.
To update its position, an Object has to provide its ID and API Key.
Location History and Geofencing APIs share Objects when both are on the same account. Each API has access to a view of an Object that is relevant for the given API.
Objects service endpoints
The Objects service contains the following endpoints:
- GETList objects
-
This endpoint obtains a list of tuples representing the user's objects. Each tuple contains a single object's UUID and name.
- GETGet object details
-
This endpoint requests all details about a single object.
- POSTAdd new object
-
This endpoint creates a new object.
- PUTEdit object
-
This endpoint provides new values for an existing object's attributes. An Admin may only send the values that need to be updated.
- DELETEDelete object
-
This endpoint provides a command used to delete objects.
Please use the navigation menu on the left-side of each page to find the topic and data you need.