Cómo obtener el token de la API web de Nuki y conectar tu cerradura

Check-in Easy utiliza un token de la API web de Nuki para consultar tus cerraduras y crear, actualizar o revocar códigos temporales de teclado. Aunque a veces se llame “API key”, el valor que debes copiar es el API token.

Crea el token únicamente desde Nuki Web. Da acceso a tus cerraduras, así que no lo envíes por correo ni lo introduzcas en sitios desconocidos.

Antes de empezar

• La cerradura debe estar instalada y visible en la app de Nuki.
• El acceso remoto debe funcionar mediante Wi-Fi, Thread o Nuki Bridge.
• Nuki Web debe estar activado para el dispositivo.
• Para generar PIN de huéspedes necesitas un Nuki Keypad compatible vinculado.

1. Activa Nuki Web

En la app de Nuki, selecciona la cerradura y abre Características y configuración → Integraciones → Nuki Web. Sigue las instrucciones para crear o vincular tu cuenta y verificarla.

2. Inicia sesión en Nuki Web

Abre web.nuki.io con la cuenta propietaria de la cerradura. Comprueba que el dispositivo aparezca en línea y pueda gestionarse a distancia.

3. Abre la sección API

En el menú de Nuki Web, entra en API. Dentro de API tokens, pulsa Generate API token o la acción equivalente para crear un token.

No utilices la clave OAuth ni el client ID: Check-in Easy necesita el token personal de esta sección.

4. Asigna los permisos necesarios

Ponle un nombre reconocible, como Check-in Easy, y permite:

• consultar las cerraduras de la cuenta (smartlock / smartlock.readOnly);
• consultar y gestionar autorizaciones o códigos de teclado (smartlock.auth).

Check-in Easy no necesita un permiso general para abrir o cerrar la puerta solo para gestionar códigos. Si Nuki muestra descripciones en lugar de estos nombres técnicos, selecciona los permisos equivalentes para ver dispositivos y gestionar autorizaciones.

5. Genera y copia el token

Confirma la creación y copia inmediatamente el token completo. Guárdalo temporalmente en un gestor de contraseñas.

Según Nuki, los tokens no caducan automáticamente, pero se destruyen cuando cambias la contraseña de la cuenta Nuki Web asociada. En ese caso tendrás que crear uno nuevo.

6. Configura Nuki en Check-in Easy

En Check-in Easy, ve a Integraciones → Cerraduras inteligentes, añade Nuki y pega el token en Token de la API web de Nuki. Asigna la propiedad, carga las cerraduras disponibles y selecciona la correcta.

Guarda y ejecuta la prueba de conexión. Si aparece la cerradura pero no el teclado, vincula el Keypad desde la app de Nuki y actualiza la lista.

Si falla la conexión

• 401 o token no válido: vuelve a copiarlo o genera uno nuevo.
• 403 o permisos insuficientes: recrea el token con permisos de lectura y gestión de autorizaciones.
• No aparecen cerraduras: revisa el acceso remoto, Nuki Web y la cuenta propietaria.
• No aparece el teclado: vincúlalo a esa cerradura antes de actualizar Check-in Easy.

Revoca desde Nuki Web cualquier token que ya no utilices. El token conserva acceso a todos los permisos concedidos al crearlo.