Como obter o token da API web de Nuki e conectar a túa pechadura

Check-in Easy utiliza un token da API web de Nuki para consultar as túas pechaduras e crear, actualizar ou revogar códigos temporais de teclado. Aínda que ás veces se lle chame “API key”, o valor que debes copiar é o API token.

Crea o token unicamente desde Nuki Web. Dá acceso ás túas pechaduras, así que non o envíes por correo nin o introduzas en webs descoñecidas.

Antes de comezar

• A pechadura debe estar instalada e visible na app de Nuki.
• O acceso remoto debe funcionar mediante Wi-Fi, Thread ou Nuki Bridge.
• Nuki Web debe estar activado para o dispositivo.
• Para xerar PIN de hóspedes necesitas un Nuki Keypad compatible vinculado.

1. Activa Nuki Web

Na app de Nuki, selecciona a pechadura e abre Características e configuración → Integracións → Nuki Web. Sigue as instrucións para crear ou vincular a conta e verificala.

2. Inicia sesión en Nuki Web

Abre web.nuki.io coa conta propietaria da pechadura. Comproba que o dispositivo apareza en liña e se poida xestionar a distancia.

3. Abre a sección API

No menú de Nuki Web, entra en API. Dentro de API tokens, preme Generate API token ou a acción equivalente.

Non utilices a clave OAuth nin o client ID: Check-in Easy precisa o token persoal desta sección.

4. Asigna os permisos necesarios

Ponlle un nome recoñecible, como Check-in Easy, e permite:

• consultar as pechaduras da conta (smartlock / smartlock.readOnly);
• consultar e xestionar autorizacións ou códigos de teclado (smartlock.auth).

Check-in Easy non precisa un permiso xeral para abrir ou pechar a porta só para xestionar códigos. Se Nuki mostra descricións no canto destes nomes técnicos, selecciona os permisos equivalentes para ver dispositivos e xestionar autorizacións.

5. Xera e copia o token

Confirma a creación e copia inmediatamente o token completo. Gárdao temporalmente nun xestor de contrasinais.

Segundo Nuki, os tokens non caducan automaticamente, pero destrúense cando cambias o contrasinal da conta Nuki Web asociada. Nese caso terás que crear un novo.

6. Configura Nuki en Check-in Easy

En Check-in Easy, vai a Integracións → Pechaduras intelixentes, engade Nuki e pega o token en Token da API web de Nuki. Asigna a propiedade, carga as pechaduras dispoñibles e selecciona a correcta.

Garda e executa a proba de conexión. Se aparece a pechadura pero non o teclado, vincula o Keypad desde a app de Nuki e actualiza a lista.

Se falla a conexión

• 401 ou token non válido: volve copialo ou xera un novo.
• 403 ou permisos insuficientes: recrea o token con permisos de lectura e xestión de autorizacións.
• Non aparecen pechaduras: revisa o acceso remoto, Nuki Web e a conta propietaria.
• Non aparece o teclado: vincúlao a esa pechadura antes de actualizar Check-in Easy.

Revoga desde Nuki Web calquera token que xa non utilices. O token conserva acceso a todos os permisos concedidos ao crealo.