Skip to main content

UniFi Reference Adapter

The UniFi adapter integrates Ubiquiti UniFi Access (door locks) and UniFi Network (Wi-Fi hotspots) with SpaceOS.

Supported Devices​

DeviceUniFi ProductActions
Door LockUA-Door, UA-Hubunlock, lock, status
Wi-Fi HotspotUniFi AP seriesgenerate_voucher, revoke_voucher, status
CameraUniFi Protectsnapshot (optional)

Configuration​

VariableDescription
UNIFI_HOSTUniFi Controller address
UNIFI_USERNAMEAdmin username
UNIFI_PASSWORDAdmin password
UNIFI_SITESite name (default: default)

Wi-Fi Voucher Generation​

When a booking starts and the Wi-Fi adapter is configured:

  1. Adapter receives POST /action with action: "generate_voucher"
  2. Calls UniFi Hotspot Manager API to create a time-limited voucher
  3. Returns voucher code and expiry
  4. Code is included in the magic link email

Door Access​

  1. Adapter receives POST /action with action: "unlock"
  2. Calls UniFi Access API to unlock the door for a configured duration
  3. Door auto-relocks after timeout

Next Steps​