1. Bluetooth command
Smart lock
English
  • 中文
  • English
  • Auth
    • Login
      POST
    • Code
      POST
    • Register
      POST
  • Lock
    • Query all locks held by the current user
      GET
    • Query the current lock details information
      GET
  • Password
    • Query all passwords of the current user
      GET
    • Time-limited password (offline password)
      POST
    • Single-time password (offline password)
      POST
    • Permanent password (offline password)
      POST
    • Clear the password (using this password to unlock, so the password will become invalid)
      POST
    • Cyclic cipher (offline cipher)
      POST
    • Password details
      GET
    • Delete password
      POST
    • Add password interface (to be called after the password is generated)
      POST
    • Change password
      POST
  • Bluetooth command
    • Door Lock Binding (Apartment)
      POST
    • Door Lock Binding (Dlock)
      POST
    • Add Lock Use
      POST
    • Modify Lock User
      POST
    • Delete Lock User
      POST
    • Read Door Lock Settings
      POST
    • Initialize Door Lock
      POST
    • Sync Door Lock Users
      POST
    • Sync Door Lock Operation Records
      POST
    • Get Lock Report Command Operations
      POST
    • Issue Door Lock Settings
      POST
    • Issue 4G Module Association
      POST
    • Issue Door Lock Operations
      POST
  • Card
    • Report card data (add card)
    • Delete Card
    • Get the current user's card list
    • Card Details
    • Modification Card
  • Fingerprint
    • Delete fingerprint
    • Report fingerprint data (add fingerprint)
    • Get the current fingerprint user list
    • Fingerprint Details
    • Modify fingerprint
  • Remote control
    • Delete remote
    • Report remote control data (add remote control)
    • Get the current list of remote control users
    • Remote control details
    • Modify remote control
  • Face
    • Delete face
    • Report facial data (add face)
    • Get the current list of facial recognition users
    • Facial Details
    • Modify face
  • Palm lines
    • Remove palm lines
    • Report palm print data (add palm print)
    • Get the current palm print user list
    • Palm print details
    • Modify palm lines
  • Door lock reports to the update server
    • Delete door lock
    • Save system settings
    • Synchronized door lock records (records not reported by the synchronized lock end)
    • Save lock end user
    • Save door lock settings
    • Save the door lock record, the current command is 0300 to call save
    • Report door lock binding 0700
    • 4G module association reporting
  • Operation Record
    • Get the current user's operation records
    • Delete operation records
    • Door lock records (no alarms)
  • Gateway
    • Query all gateways
    • Send instruction to unbind the gateway-door lock association
    • Unbind Gateway from Server-side User
  • Card issuing machine related interfaces
    • Method 1 for Binding the Card Issuing Machine
    • Method 2 for Binding the Card Issuing Machine
    • Delete card issuer
    • Delete online card
    • Create an online card to door lock device
    • Create an offline card for the hotel apartment
    • Online Card Save
    • Issue command to start collecting fingerprint data
    • Issue the command to stop collecting fingerprint data
    • Unbind card issuing machine
    • Synchronize and send fingerprint data to the door lock device
    • Query all card information based on the cardholder
  • 4G Direct Connection
    • Issue the command to associate the direct connection module with the door lock.
    • Report the association results of the direct connection module
    • Check the status of the direct connection module
    • 4G password delivery
  • 数据模型
    • 数据
    • 上报
    • 修改
    • 上报commonFormatData
    • 离线密码
    • 指令通用数据模型
  1. Bluetooth command

Add Lock Use

POST
/command/addUser
Send a command to the specified door lock to add a user, creating new user information on the device side, and support configuring parameters such as user name, permission level, and unlocking method (fingerprint / card / password / facial recognition / palm print). After the command is issued, the door lock will generate a user record locally and grant the corresponding unlocking permissions.
Important Notes:
The user name must be unique on the device to avoid conflicts with existing users. Different unlocking methods must correspond to the device-supported enrollment process (for example, fingerprints require guiding the user to press for collection). After successful invocation, the obtained data (command packet) should be written to the door lock device via Bluetooth.
Usage Scenario: Add authorized users for family members or visitors and configure different permission levels (e.g., administrator / regular user / temporary user).
timeZone: 01-0C from UTC+1 to UTC+12, 81-8C from UTC-1 to UTC-12, 00 for UTC
Offline passwords exclude year, month, day, hour, minute, and second.

请求参数

Header 参数

Body 参数application/json

示例
{
    "effectiveTime": "14:37",
    "deviceId": "a0:10:8a:fd:de:f3",
    "childId": "63:2d:99:84:a1:fe",
    "effectiveDate": "2026-04-07",
    "failDate": "2026-11-28",
    "failTime": "07:14",
    "effectiveDays": "0,1,2,3,4,5,6",
    "password": "548699366",
    "name": "e",
    "isDoorMode": "1",
    "isEnterMenu": "1",
    "isLocked": "0",
    "isAlwaysOpen": "0",
    "isEffective": "0",
    "deviceState": "05",
    "agingType": "03"
}

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{"code":200,"msg":"成功","total":0,"data":"5B004001016929443A000101114000DC02695CB3DA48DE8507D56C2FAF7AEE2CEF97F9F591E220850B599B055FCEDAAFAFB0482BE2ED406E4062DD19DB719A50424F00B5726E","success":true}
上一页
Door Lock Binding (Dlock)
下一页
Modify Lock User
Built with