Bluetooth communication

API endpoints

POST asyncSend

Sends a raw Bluetooth Low Energy packet to the lock via the Wi-Fi hub.

Tip

Many of the actions done by the Lockly app over Wi-Fi are implemented through the use of this endpoint.

Request encryption

User

Request JSON Object
  • acct (string) – The user’s account name.

  • cmd (string) – The BLE packet, in a hexadecimal encrypted form.

  • dv (string) – The door lock identifier. See also: POST qrylknew.

  • mdna (string) – The Wi-Fi hub’s IoT device management name. See also: POST qrylknew.

Response JSON Object
  • req_msg_id (string) – The request message ID. Used in MQTT messages.

Example request

{
  "acct": "user@example.org",
  "cmd": "aa00bb11cc22dd33ee44ff55aa00bb11cc22dd33ee44ff55aa00bb11cc22dd33ee44ff55aa00bb11",
  "directive": "lock",
  "dv": "300030001234567890123456",
  "mdna": "M2T200112233"
}

Example response

{
  "cod": "200",
  "req_msg_id": 1590073500295600300
}