External Open Permissions a.k.a allow Pindora to open the lock
With this endpoint you will be able to set a permission for Pindora to open the lock. After setting the permission for a Pindora using this endpoint, the Pindora will behave the same way as it would if the user would have typed in a PIN code.
In other words, you just set the external open permission (for example through your own app) and then knock on the door. Pindora will open the lock.
To create an external permission
POST
https://admin.pindora.fi/api/integration/openpermissions
Required scope
dooropengrand.create
To issue a new external permission for Pindora to open, the client needs to send a POST request with following request body parameters as JSON to
https://admin.pindora.fi/api/integration/openpermission :
Parameter | Required | Type | Description |
pindora.id | Yes
Note: In the next minor release, this parameter will be optional and only mandatory if more than one Pindora exists. | string | ID of the Pindora you want to give the permission to. |
id | Yes | string | Your own ID for this permission. It can be whatever you want to map it to your internal transaction logs |
Examples
Request example using Curl
curl --request POST \
--url
https://admin.pindora.fi/api/integration/openpermissions \
--header 'Pindora-Api-Key: d217d336-550g-4dd3-b834-b7deb95b7607' \
--header 'content-type: application/vdn.pindora.v1+json' \
--data '{"pindora":{"id":"66c1b208-7b31-4747-a331-fc9753634104"},"id": "ext-1"}'
Full request data sent (example)
POST /api/integration/openpermissions HTTP/1.1
Host: admin.pindora.fi
Accept: application/vdn.pindora.v1+json
Pindora-Api-Key: d217d336-550g-4dd3-b834-b7deb95b7607
{
"pindora": {
"id": "66c1b208-7b31-4747-a331-fc9753634104"
},
"id": "ext-1"