Com obtenir el token de l’API web de Nuki i connectar el teu pany

Check-in Easy utilitza un token de l’API web de Nuki per consultar els teus panys i crear, actualitzar o revocar codis temporals de teclat. Encara que de vegades se’n digui “API key”, el valor que has de copiar és l’API token.

Crea el token únicament des de Nuki Web. Dona accés als teus panys, així que no l’enviïs per correu ni l’introdueixis en webs desconegudes.

Abans de començar

• El pany ha d’estar instal·lat i visible a l’app de Nuki.
• L’accés remot ha de funcionar mitjançant Wi-Fi, Thread o Nuki Bridge.
• Nuki Web ha d’estar activat per al dispositiu.
• Per generar PIN d’hostes necessites un Nuki Keypad compatible vinculat.

1. Activa Nuki Web

A l’app de Nuki, selecciona el pany i obre Característiques i configuració → Integracions → Nuki Web. Segueix les instruccions per crear o vincular el compte i verificar-lo.

2. Inicia sessió a Nuki Web

Obre web.nuki.io amb el compte propietari del pany. Comprova que el dispositiu aparegui en línia i es pugui gestionar remotament.

3. Obre la secció API

Al menú de Nuki Web, entra a API. Dins d’API tokens, prem Generate API token o l’acció equivalent.

No utilitzis la clau OAuth ni el client ID: Check-in Easy necessita el token personal d’aquesta secció.

4. Assigna els permisos necessaris

Posa-li un nom reconeixible, com ara Check-in Easy, i permet:

• consultar els panys del compte (smartlock / smartlock.readOnly);
• consultar i gestionar autoritzacions o codis de teclat (smartlock.auth).

Check-in Easy no necessita un permís general per obrir o tancar la porta només per gestionar codis. Si Nuki mostra descripcions en lloc d’aquests noms tècnics, selecciona els permisos equivalents per veure dispositius i gestionar autoritzacions.

5. Genera i copia el token

Confirma la creació i copia immediatament el token complet. Desa’l temporalment en un gestor de contrasenyes.

Segons Nuki, els tokens no caduquen automàticament, però es destrueixen quan canvies la contrasenya del compte Nuki Web associat. En aquest cas n’hauràs de crear un de nou.

6. Configura Nuki a Check-in Easy

A Check-in Easy, ves a Integracions → Panys intel·ligents, afegeix Nuki i enganxa el token a Token de l’API web de Nuki. Assigna la propietat, carrega els panys disponibles i selecciona el correcte.

Desa i executa la prova de connexió. Si apareix el pany però no el teclat, vincula el Keypad des de l’app de Nuki i actualitza la llista.

Si falla la connexió

• 401 o token no vàlid: torna a copiar-lo o genera’n un de nou.
• 403 o permisos insuficients: recrea el token amb permisos de lectura i gestió d’autoritzacions.
• No apareixen panys: revisa l’accés remot, Nuki Web i el compte propietari.
• No apareix el teclat: vincula’l a aquell pany abans d’actualitzar Check-in Easy.

Revoca des de Nuki Web qualsevol token que ja no utilitzis. El token conserva accés a tots els permisos concedits en crear-lo.