In Genetec Clearance™, devices represent Body Wearable Cameras that are in a user's possession and are managed by the Device API and the Device User Relationship API. Managing devices through APIs allows integrators to access key information about the source of their Evidence data through Clearance.
Device API
The Device API describes the device in the system, including details like the serial number, make, model, and activation status. Integrators can use this API to populate the Device list for an account or activate the license for a device. For detailed information about managing devices, see Device Service API.
Device User Relationship API
Licensed functionality:
The functionality described in this section is licensed under specific terms per customer account and require activation.
Contact Genetec for more information.
The Device User Relationship API is used to implement association between a device and a user in the system, allowing for easier searching and visualization of files. This association is based on a calendar schedule that can be retrieved and updated from the API.
When a video or image file is uploaded to Clearance, the identity of the user that recorded the file is not sent. Clearance simply requests the device used for recording. The API establishes a connection between the user in the system and the device used for recording (identified by its device identification) at the time the video or image was captured.
The idea behind this system is to decouple the identity of the user with the actual file (to allow easier correction after the fact). The association can be updated at any time, whether in the future or the past, ensuring that the file accurately represents the originator of the video.
For detailed information about the API call, consult Device User Relationship Service API.
