Integrare Schlage Encode Plus con Shangrilux
Configura Schlage Encode Plus in Wi-Fi diretto per gestire PIN di accesso temporanei via Schlage Home API.
Nota: Schlage Encode Plus richiede Wi-Fi 2.4 GHz (non 5 GHz). Modelli supportati: BE489WB, BE499WB. L'API Schlage Home è disponibile per partner certificati.
Prerequisiti
- Schlage Encode Plus installato e connesso al Wi-Fi 2.4 GHz
- App Schlage Home configurata con account registrato
- Accesso API Schlage (richiesta partner access su developer.schlage.com)
- Massimo 100 access codes per serratura (limite hardware)
Configurazione
Registra account developer Schlage
Visita developer.schlage.com → Partner Program → Submit Application. Indica il caso d'uso (hospitality management platform). Schlage fornisce sandbox credentials entro 5-7 giorni.
Autenticazione OAuth2
Schlage usa OAuth2 con PKCE. Shangrilux gestisce il flow automaticamente dopo l'inserimento delle credenziali partner.
Scopri dispositivi e serrature
GET /devices → ritorna lista serrature Schlage collegate all'account con deviceId, modello e stato.
Gestione Access Codes
Crea codici di accesso temporanei per ogni prenotazione:
# Crea access code temporaneo
curl -X POST https://api.schlage.com/v1/devices/{deviceId}/accessCodes \
-H "Authorization: Bearer ACCESS_TOKEN" \
-d '{
"name": "Ospite Verdi 01/06",
"code": "3847",
"codeType": "scheduled",
"schedule": {
"startTime": "2026-06-01T14:00:00-05:00",
"endTime": "2026-06-05T11:00:00-05:00"
}
}'Configura in Shangrilux
Admin → Integrazioni → Schlage → inserisci Client ID, Client Secret. Dopo autorizzazione OAuth, seleziona le serrature da gestire. Shangrilux creerà e revocherà i codici automaticamente.
Limitazioni e Best Practice
- Limite di 100 codici per serratura: Shangrilux pulisce automaticamente i codici scaduti prima di crearne di nuovi
- Codici 4-8 cifre: non usare combinazioni ovvie (1234, 0000)
- Schlage Encode Plus non supporta carte RFID: solo PIN numerico
- Per strutture con alta rotazione ospiti: usa codici unici per ogni prenotazione (non riusare PIN)
Attenzione: Schlage Encode Plus memorizza i codici localmente nella serratura. In caso di serratura offline (Wi-Fi giù), i codici già programmati continuano a funzionare, ma non è possibile aggiungerne di nuovi.