Smart Lock·Intermedio 12 minAggiornato: 30 marzo 2026

Integrare Serrature TTLock con Shangrilux

Configura qualsiasi serratura con chip TTLock tramite l'Open API per gestione centralizzata dei codici ospite.

Nota: TTLock è un sistema OEM utilizzato da oltre 200 brand di serrature (Ultraloq, Smonet, Teeho, Keyless, ecc.). L'integrazione funziona con tutti i modelli compatibili TTLock che abbiano un Gateway G2 o G3 connesso.

Prerequisiti

Serratura con chip TTLock installata e configurata nell'app TTLock
Gateway TTLock G2 o G3 connesso alla rete Wi-Fi
Account sviluppatore su open.ttlock.com (gratuito)
Client ID e Client Secret dell'applicazione creata

Registrazione Account Developer

Crea un'applicazione API su TTLock Open Platform

Vai su open.ttlock.com → Registrati con email aziendale → Dashboard → Crea Applicazione. Inserisci nome app, descrizione e callback URL. Otterrai Client ID e Client Secret.

Trasferisci i dispositivi all'account developer

Nell'app TTLock mobile → Serratura → Condividi → inserisci l'email del tuo account developer TTLock. I dispositivi appariranno nel portale open.ttlock.com → Devices.

Ottieni access_token OAuth2

TTLock usa OAuth2 Password Grant. Chiama l'endpoint di autenticazione:

bash

curl -X POST https://euapi.ttlock.com/oauth2/token \
  -d "client_id=TUO_CLIENT_ID" \
  -d "client_secret=TUO_CLIENT_SECRET" \
  -d "username=TUA_EMAIL" \
  -d "password=MD5(TUA_PASSWORD)" \
  -d "grant_type=password"
# Risposta: { "access_token": "...", "refresh_token": "...", "expires_in": 7776000 }

Recupera lista serrature

GET https://euapi.ttlock.com/v3/lock/list?clientId=...&accessToken=...&pageNo=1&pageSize=20&date=TIMESTAMP → copia il "lockId" per ogni serratura da integrare.

Configura in Shangrilux

Admin → Integrazioni → TTLock → inserisci Client ID, Client Secret, Access Token, Refresh Token. Shangrilux gestirà automaticamente il rinnovo del token alla scadenza (90 giorni).

Generazione automatica Passcode ospite

Per ogni prenotazione confermata, Shangrilux chiama POST /v3/keyboardPwd/get per creare un passcode temporaneo con startDate e endDate corrispondenti a check-in e check-out.

json

// Richiesta creazione passcode
{
  "clientId": "CLIENT_ID",
  "accessToken": "ACCESS_TOKEN",
  "lockId": 1234567,
  "keyboardPwdType": 2,
  "keyboardPwdName": "Ospite Mario Rossi",
  "startDate": 1748649600000,
  "endDate": 1748822400000,
  "date": 1748563200000
}
// Risposta: { "keyboardPwdId": 987654, "keyboardPwd": "281945" }

Verifica e Monitoraggio

Controlla in Shangrilux Admin → Dispositivi che la serratura mostri stato "Online"
Crea una prenotazione test: verifica che il passcode sia generato e visibile nel log
Testa l'accesso fisicamente con il codice generato
Verifica che al check-out il codice venga eliminato (DELETE /v3/keyboardPwd/delete)

Attenzione: La TTLock Open API EU ha rate limit di 1 richiesta/secondo. Shangrilux gestisce la coda automaticamente. Non creare integrazioni parallele che usino lo stesso token per evitare il ban temporaneo.

#ttlock#open-api#smart-lock#passcode