Integrare Yale Smart Lock con Shangrilux
Configura le serrature Yale Conexis, Linus e Assure tramite Yale Access API o Z-Wave via Home Assistant.
Scegli il Metodo di Integrazione
| Modello Yale | Protocollo | Metodo consigliato | Difficoltà |
|---|---|---|---|
| Yale Conexis L2 | Bluetooth + Yale Connect Bridge | Yale Cloud API | Facile |
| Yale Linus L2 | Bluetooth + Yale Connect Bridge | Yale Cloud API | Facile |
| Yale Assure SL | Z-Wave Plus | Z-Wave via HA | Avanzato |
| Yale Assure 2 | Z-Wave / Zigbee | Z-Wave via HA | Avanzato |
| Yale Unity | Wi-Fi diretto | Yale Access API | Intermedio |
Metodo A: Yale Access API (Cloud)
Attiva Yale Connect Bridge
Il Bridge Yale collegato in rete LAN è necessario per la connettività cloud. Configuralo nell'app Yale Access. Verifica che la serratura sia "Online" nell'app.
Richiedi accesso API Yale
Yale ha un processo di approvazione per gli sviluppatori. Contatta developer@yalehome.com con il tuo use case (integrazione B2B hospitality). Il processo richiede 3-5 giorni lavorativi.
OAuth2 e accesso alle serrature
Una volta approvato, usa il flow OAuth2 per autorizzare Shangrilux ad accedere all'account Yale del cliente:
# Ottieni lista serrature Yale
curl -X GET https://api.yalehome.com/v1/locks \
-H "Authorization: Bearer YALE_ACCESS_TOKEN"
# Risposta: lista serrature con lockId, nome, statoInvia codici ospite
Genera PIN temporanei per ogni prenotazione:
curl -X POST https://api.yalehome.com/v1/locks/{lockId}/pinCodes \
-H "Authorization: Bearer YALE_ACCESS_TOKEN" \
-d '{"code":"481902","name":"Ospite Bianchi","startTime":"2026-06-01T14:00:00Z","endTime":"2026-06-05T11:00:00Z"}'Metodo B: Yale Assure via Z-Wave + Home Assistant
Aggiungi la serratura al controller Z-Wave
Usa Z-Wave JS UI in Home Assistant. Modalità pairing: tieni premuto il pulsante program della serratura finché il LED lampeggia. La serratura appare come entity "lock.yale_assure_xxx".
Integra HA con Shangrilux
Segui la guida Home Assistant (presente nel Blog) per collegare l'entity Yale ad Shangrilux tramite REST API. Mappa lock.yale_assure_xxx al dispositivo in Shangrilux.