REST API for managing smart locker transactions and physical operations.This service runs on a computer embedded within a smart locker installation and provides an API for managing locker transactions and operations over a local area network.Create and manage transactions
Control physical locker door operations (open individual lockers or all lockers)
Access system information including network details
Retrieve system logs for debugging and monitoring
Service discovery via mDNS on the local network
Multiple locker towers per installation, each with independent control boardsA "tower" is the physical locker bank structure
A "control board" is the embedded electronics that control a tower
Door operations include sensor feedback (physical door state)
Transactions persist locally in a database
The system does NOT track physical items, only transaction status
Customers cannot specify which locker to assign - the system selects automatically
Door open operations: 20-second timeout per attempt, up to 3 attempts with 1-second delays between retries (maximum total time ~62 seconds). Retries occur on network/communication errors only; hardware malfunctions are not retried.
Locker status uses independent boolean flags (outOfService, operational, doorOpen) that can coexist and the available flag is derived from them
Diagnostic info (reasonCode, reason) provided when lockers are unavailable
1.
Create a transaction → System assigns an available locker
2.
Open locker by transaction ID → Place item in locker
3.
Open locker again → Remove item from locker
4.
Delete transaction → Release locker for reuse
Modified at 2025-12-02 23:36:10
