Request a Key is deprecated
We have decided to deprecate the "Request a Key" feature in the Service Provider Api. If you are interested in why or you want to know what we recommend as an alternative, please contact us.
Batch Create Keys
We now have a new endpoint for batch-creating keys. The endpoint accepts an array of key data, formatted in the same way as the regular create key endpoint, and returns a job ID that can be checked using the new async job status endpoint.
Key Duration
- The create-key endpoint now accept
durationMinutes
. This means that you can set a start and duration for a key, instead of having to calculate end time yourself. - We also fixed a bug where it was not possible to remove address from a lock.
Two new endpoints
- There's a new endpoint for getting a single vendor connection. You can poll this when creating or refreshing a vendor connection.
- There's a new endpoint for getting your integrator.
Lock Holder Events, format phone number endpoint, and more
- There's a new endpoint that provides Lock Holder level Events: You will get a list of Key events for Locks under a specific Lock Holder.
- A new set of webhook endpoints are available for you to hook up to Lock Holder events: Create webhook, Get webhooks, Delete webhook.
- We added an endpoint that attempts to properly format Mobile Phone Numbers in a way that would be recognized by the API.
- Added request examples to the documentation: These examples will prefill the request body using the required data for each scenario. Check out this video to see how to use it. Endpoints with request examples:
- We have added an additional endpoint to create Keys: The behavior is exactly the same as the existing one, only with this endpoint you send the Lock ID as as body param.
New Vendor Connections with the same credentials no longer overwrite existing ones
Creating a new Vendor Connection that reuses the credentials of an existing Vendor Connection no longer disconnects the existing one. Instead, a 409 error is returned.
Get a single Key & Prefetch Keys
-
The Integrator API now includes a Get a single Key endpoint.
-
Service Providers can take advantage of a new App Switch URL:
prefetchkeys
. Using it will make the Unloc app download all the Keys associated with a user beforehand, instead at the time of opening a Lock. This improves performance by having all the Keys immediately available, and, covers the case where a Lock might be located at a place with poor or no internet coverage whatsoever.
Custom Key metadata
You can now embed custom metadata on Keys you create using the Integrator API.
Lock battery status
Endpoints that return Lock data now contain a new property intended to display Lock's battery information.
Service Provider Key creation request error
When a Service Provider attempts to create a Key for a Lock who's Lock Holder's Vendor Connection is in an error state, a 403 error code will be returned. Previously the Key creation endpoint returned 200 regardless of the Vendor Connection state.