Nola lortu Nuki Web API tokena eta zure sarraila konektatu

Check-in Easy-k Nuki Web API tokena erabiltzen du zure sarrailak kontsultatzeko eta teklatuko aldi baterako kodeak sortu, eguneratu edo ezeztatzeko. Batzuetan “API key” esaten bazaio ere, kopiatu beharreko balioa API tokena da.

Sortu tokena Nuki Web atarian soilik. Zure sarrailetarako sarbidea ematen du; ez bidali posta elektronikoz eta ez sartu webgune ezezagunetan.

Hasi aurretik

• Sarrailak instalatuta eta Nuki aplikazioan ikusgai egon behar du.
• Urruneko sarbideak Wi-Fi, Thread edo Nuki Bridge bidez funtzionatu behar du.
• Nuki Web aktibatuta egon behar du gailurako.
• Gonbidatuentzako PINak sortzeko, Nuki Keypad bateragarri bat lotu behar da.

1. Aktibatu Nuki Web

Nuki aplikazioan, hautatu sarraila eta ireki Ezaugarriak eta konfigurazioa → Integrazioak → Nuki Web. Jarraitu kontua sortzeko edo lotzeko eta egiaztatzeko urratsei.

2. Hasi saioa Nuki Web-en

Ireki web.nuki.io sarrailaren jabe den kontuarekin. Egiaztatu gailua linean dagoela eta urrunetik kudea daitekeela.

3. Ireki API atala

Nuki Web menuko API atalera joan. API tokens barruan, sakatu Generate API token edo token bat sortzeko aukera baliokidea.

Ez erabili OAuth gakoa edo client IDa: Check-in Easy-k atal honetako token pertsonala behar du.

4. Esleitu beharrezko baimenak

Eman izen argi bat, adibidez Check-in Easy, eta baimendu:

• kontuko sarrailak kontsultatzea (smartlock / smartlock.readOnly);
• baimenak edo teklatuko kodeak kontsultatu eta kudeatzea (smartlock.auth).

Check-in Easy-k ez du atea zuzenean ireki edo ixteko baimen orokorrik behar kodeak kudeatzeko. Nuki-k deskribapenak erakusten baditu izen teknikoen ordez, aukeratu gailuak ikusteko eta baimenak kudeatzeko baliokideak.

5. Sortu eta kopiatu tokena

Berretsi sorrera eta kopiatu token osoa berehala. Gorde aldi baterako pasahitz-kudeatzaile batean.

Nuki-ren arabera, tokenak ez dira automatikoki iraungitzen, baina lotutako Nuki Web kontuaren pasahitza aldatzean suntsitzen dira. Kasu horretan, token berria sortu behar da.

6. Konfiguratu Nuki Check-in Easy-n

Check-in Easy-n, joan Integrazioak → Sarraila adimendunak atalera, gehitu Nuki eta itsatsi tokena Nuki Web API Tokena eremuan. Esleitu jabetza, kargatu sarrailak eta hautatu dagokiona.

Gorde eta egin konexio-proba. Sarraila agertzen bada baina teklatua ez, lotu Keypad-a Nuki aplikazioan eta eguneratu zerrenda.

Konexioak huts egiten badu

• 401 edo token baliogabea: kopiatu berriro edo sortu beste bat.
• 403 edo baimen eskasak: sortu tokena berriro irakurketa- eta baimen-kudeaketako eskubideekin.
• Sarrailarik ez: egiaztatu urruneko sarbidea, Nuki Web eta jabe-kontua.
• Teklaturik ez: lotu sarraila zehatz horri Check-in Easy eguneratu aurretik.

Ezeztatu Nuki Web-en erabiltzen ez dituzun tokenak. Tokenak sortzean emandako baimen guztiak mantentzen ditu.