Integrare August Smart Lock con Shangrilux
Configura August Wi-Fi Smart Lock e August Pro tramite August API per gestione PIN ospiti e apertura remota.
Nota: August Wi-Fi Smart Lock (4a generazione) si connette direttamente al Wi-Fi 2.4 GHz senza bridge aggiuntivo. August Pro e Smart Lock 3a gen richiedono August Connect Wi-Fi Bridge. Questa integrazione usa le August Connect API.
Prerequisiti
- August Smart Lock installato e configurato nell'app August Home
- August Connect Wi-Fi Bridge collegato (per modelli senza Wi-Fi integrato)
- Account August Developer (developer.august.com)
- API Key approvata (richiede approvazione manuale August)
Configurazione
Registra applicazione API August
Accedi a developer.august.com → Request API Access. Compila il modulo con: nome app "Shangrilux", use case "hospitality management", numero di serrature gestite. August risponde entro 3-5 giorni lavorativi con le credenziali.
Autenticazione e recupero serrature
August usa un flow di autenticazione email + validazione codice:
# Step 1: Invia codice di verifica all'email
curl -X POST https://api-production.august.com/session \
-H "Accept-Version: 0.0.1" \
-H "x-august-api-key: TUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"password":"tua-password","email":"tua@email.com","phone":null}'
# Step 2: Verifica il codice ricevuto via email
curl -X POST https://api-production.august.com/validate/email \
-H "x-august-api-key: TUA_API_KEY" \
-H "x-august-access-token: TOKEN_DA_STEP1" \
-d '{"code":"123456"}'Lista serrature
GET /locks → ritorna tutte le serrature associate all'account con lockId, nome, stato (locked/unlocked) e livello batteria.
Configura in Shangrilux
Admin → Integrazioni → August → inserisci API Key e token di sessione. Shangrilux mapperà automaticamente le serrature disponibili.
Gestione Guest Access Codes
Crea codici pin temporanei per gli ospiti:
# Crea access code temporaneo
curl -X POST https://api-production.august.com/lock/{lockId}/accesscode \
-H "x-august-api-key: TUA_API_KEY" \
-H "x-august-access-token: TUO_TOKEN" \
-d '{
"name": "Ospite Bianchi",
"code": "4729",
"startTime": "2026-06-01 14:00:00",
"endTime": "2026-06-05 11:00:00",
"accesscodeType": "all_day_recurring",
"duration": 30
}'Apertura Remota
Remote unlock per check-in digitale
Shangrilux può aprire la serratura da remoto al check-in confermato: PUT /lock/{lockId}/remoteoperate con payload {"status":"unlock"}. La serratura si richiude automaticamente dopo il timeout configurato.
Consiglio: August supporta "Activity Feed" in tempo reale: ogni evento (apertura, chiusura, codice inserito) è disponibile tramite GET /lock/{lockId}/activities. Shangrilux importa questi eventi per il log accessi della struttura.