With the release of version 6.0 of the Kontakt.io Proximity REST API, we’ve introduced the concept of shareable venues and devices. In this article, we’ll explore what that means for your deployments and how to use this feature to create and manage your own network of shared venues and devices.
You can share venues, complete with all associated devices and actions, with other users. You can also share individual devices and allow users to add them to their own venues.
You can only share with managers outside of your company. The manager must be ‘known’ in the Kontakt.io Cloud, and you’ll need to know their account email in order to share your devices and venues with them.
Only the owner/manager of the venue or device can initiate the share.
Any shares will be visible to your supervisor managers.
You can share your venues publicly by sharing them with the ‘public manager’ firstname.lastname@example.org. Any user with the Kontakt.io Public API key can access these public venues.
You can share in one of two ways:
Once you share a venue/device with a manager or managers, they will receive an email containing information for the shared device.
When you share a venue or device, by default it will be shared forever or until you delete or unshare it. You have the option to specify an expiry date when you create the share. The device or venue will be ‘unshared’ when the date is reached.
When you list venues and devices, the ShareType will be displayed. This can have one of the following values:
The first two values tell you about your company’s devices and not about sharing.
If a device/venue is shared with you:
The owner of a shared device can withdraw the share at any time. If you withdraw a device that was shared as EDITOR then all changes to this device will be lost.
Read more about Shareable Venues and Devices at our Developers Center.