← Device Remote API

POST/v1/devices/{device-id}/remote-activationRemote activate a device

This method allows you to remotely activate a device, using a gateway. The status of the server-call and the lock-activation are displayed differently. If the server returns a 200, that means that the server-call has succeeded. The result of the lock-activation is logged in the body of the return object.
parameteruuidWeb-key UUID for unauthenticated remote activation: String, UUID 4 formatted (e.g. "a426e157-8a5c-456a-8865-bec6394867ab")
parameterlanguagePreferred language for error messages: Language code (ISO 639-1, e.g. "ar", "de", "en", "es", "fr", "it", "nl", "pl", "cs")
headerAuthorizationAuthentication token (bearer token or API key).

Response

status200All ok
status401Invalid authentication token
status403Insufficient rights
status404Device/Gateway not found
{
"deviceId" : Number,
"errorCode" : String,
"errorMessage" : String,
"activationTime" : Number
}

Example: Remote activate, lock firmware <= 83 || gateway firmware <= 32

POST/v1/devices/14/remote-activation

headerAuthorizationBearer 0d473b80-3a90-4ac3-bb5f-052435c87298

Response

status400
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"message": "A new firmware update is available for your Bold product. We recommend to update to the newest version to have the best experience.",
"code": "DeviceFirmwareOutdated",
"errorMessage": "A new firmware update is available for your Bold product. We recommend to update to the newest version to have the best experience.",
"errorCode": "DeviceFirmwareOutdated"
}

Example: Remote activate without gateway

POST/v1/devices/18/remote-activation

headerAuthorizationBearer c342b1ab-6da2-49f7-810a-5ab71ff15cbb

Response

status400
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"message": "No available Connect for Lock found. Please check if your connect is online.",
"code": "gatewayNotFoundError",
"errorMessage": "No available Connect for Lock found. Please check if your connect is online.",
"errorCode": "gatewayNotFoundError"
}

Example: Remote activate

POST/v1/devices/20/remote-activation

headerAuthorizationBearer 2db8ab2e-19ba-4175-8d3f-88a4658baf04

Response

status200
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"deviceId": 20,
"errorCode": "OK",
"errorMessage": "OK"
}

Example: Remote activate with uuid (web-key)

POST/v1/devices/23/remote-activation

parameteruuidd1ae1f53-50fc-4726-87c8-ad60a172884e

Response

status200
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"deviceId": 23,
"errorCode": "OK",
"errorMessage": "OK"
}