Smart Lock·Intermedio 15 minAggiornato: 30 marzo 2026

Integrare Salto KS e Salto SHIP con Shangrilux

Collega serrature Salto XS4 e ARIA con Shangrilux tramite Salto KS Cloud API o SHIP (Salto Hospitality Integration Protocol).

Nota: Salto offre due percorsi: Salto KS (cloud-based, abbonamento mensile) e Salto SHIP (on-premise, integrazione server-to-server). Questa guida copre Salto KS per la maggior parte delle installazioni hospitality.

Prerequisiti

Dispositivi Salto XS4, ARIA o NEO installati e configurati nel portale Salto KS
Account Salto KS con piano Business o superiore
API Key Salto KS (da Developer Portal)
Per Salto SHIP: server on-premise con SHIPS software installato

Metodo A: Salto KS Cloud API

Accedi al Salto KS Developer Portal

Vai su developer.saltosystems.com → registra un'applicazione partner → ottieni client_id e client_secret. Il tier gratuito include 100 device. Richiedi il tier hospitality per volumi maggiori.

Autenticazione OAuth2

Salto KS usa OAuth2 Client Credentials:

bash

curl -X POST https://api.salto-ks.com/oauth2/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=TUO_CLIENT_ID" \
  -d "client_secret=TUO_SECRET" \
  -d "scope=device.read device.write key.write event.read"
# Risposta: { "access_token": "eyJ...", "expires_in": 3600 }

Configura in Shangrilux

Admin → Integrazioni → Salto KS → inserisci Client ID e Secret. Shangrilux gestirà automaticamente il token refresh.

Lista Dispositivi

GET https://api.salto-ks.com/v2/devices?type=lock → ritorna serrature con device_id, nome, stato batteria e connettività.

Emissione Mobile Key

Per ogni prenotazione, Shangrilux crea una Mobile Key Salto con finestra temporale:

json

// POST https://api.salto-ks.com/v2/keys
{
  "device_ids": ["lock_abc", "lock_xyz"],
  "name": "Ospite Mario Rossi — Camera 201",
  "valid_from": "2026-06-01T14:00:00Z",
  "valid_until": "2026-06-05T11:00:00Z",
  "key_type": "mobile",
  "delivery": {
    "method": "email",
    "email": "ospite@email.com"
  }
}
// Risposta: { "key_id": "key_123", "qr_code_url": "https://..." }

Webhook eventi accesso

Configura webhook in Salto KS → Settings → Webhooks → aggiungi URL Shangrilux per eventi: key_used, key_rejected, battery_low.

Metodo B: Salto SHIP (On-Premise)

Per installazioni con server on-premise, Salto offre il protocollo SHIP (Salto Hospitality Integration Protocol). Il server SHIPS espone un'API SOAP/REST locale. Contatta Salto per la documentazione SHIP 3.0 e le credenziali di accesso partner.

Consiglio: Salto offre "Virtual Network" per collegare serrature offline (batteria) tramite smartphone degli ospiti. Ogni volta che l'ospite apre l'app Salto, la serratura riceve aggiornamenti programma senza connessione Wi-Fi.

#salto#salto-ks#ship#xs4#aria#rfid#access-control