Integrare Igloohome con Shangrilux tramite Iglooworks API
Genera PIN e Access Card temporanee per le serrature Igloohome automaticamente ad ogni prenotazione.
Nota: Igloohome usa la tecnologia algoPIN™: i codici PIN funzionano anche offline. La serratura calcola il PIN valido basandosi su algoritmo crittografico. Nessun Bridge richiesto per la generazione PIN.
Prerequisiti
- Serratura Igloohome (Deadbolt, Padlock, Keybox) installata
- Account Iglooworks Business su business.igloohome.co
- API Key Business (richiede piano Business o Enterprise Iglooworks)
- Numero di serie della serratura
Configurazione Iglooworks API
Attiva il piano Business su Iglooworks
Vai su business.igloohome.co → Registrati → seleziona piano Business. Riceverai l'API Key nell'email di benvenuto (formato: igloo_xxxxxxxx).
Aggiungi le serrature al portale
Iglooworks Portal → Devices → Add Device → inserisci il numero di serie (QR code sul retro della serratura). Assegna un nome di proprietà per organizzazione.
Configura in Shangrilux
Admin → Integrazioni → Igloohome → inserisci API Key e seleziona le serrature da gestire.
Generazione PIN automatica
Shangrilux chiama l'API Iglooworks per generare PIN temporanei ad ogni prenotazione confermata. L'API risponde con il PIN calcolato per l'intervallo di date specificato.
# Genera PIN temporaneo per ospite
curl -X POST https://api.igloohome.co/v1/locks/{lockId}/pinCodes \
-H "Authorization: Bearer igloo_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"type": "duration",
"startDateTime": "2026-06-01T14:00:00",
"endDateTime": "2026-06-05T11:00:00",
"isActive": true,
"name": "Ospite Rossi Check-in 01/06"
}'
# Risposta: { "pinCode": "481627", "id": "pc_abc123" }Consiglio: I PIN algoPIN di Igloohome funzionano anche senza connessione internet. Ideali per strutture in zone con connettività instabile (montagna, campagna, isole).
Risoluzione Problemi
- PIN non funzionante: verifica che l'orologio della serratura sia sincronizzato (tieni premuto * per 5 secondi)
- API Key non valida: le key Iglooworks scadono ogni 12 mesi — rigenera dal portale Business
- Serratura non trovata: verifica il numero di serie e che la serratura sia assegnata all'account Business