FHEM/mod-NUKI
1
0
Fork 0
Code Issues 1 Pull Requests Releases 3 Wiki Activity

„Documents Bridge API“ ändern

Marko Oldenburg
2021-11-28 21:42:17 +01:00
parent 2e688a1d2b
commit 2bae387c6f
1 changed files with 26 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
Documents-Bridge-API.md

@ -42,7 +42,31 @@ If discovery is disabled via /configAuth or through the Nuki App, the IP is 0.0.
#### 3.1.1 Alternative via Nuki App
As an alternative you can activate and manage the Bridge API via the Nuki App by opening Burger menu > Manage my devices > Bridge and follow the described steps:
![](https://developer.nuki.io/uploads/default/original/2X/f/fc5af490e90aede9af89461fe7b1f71a178f6fba.jpeg)
<img src="https://developer.nuki.io/uploads/default/original/2X/f/fc5af490e90aede9af89461fe7b1f71a178f6fba.jpeg" width="100">
<img src="https://developer.nuki.io/uploads/default/original/2X/0/0db3646d61045e5d1097ecf58e2bffcc2973c158.jpeg" width="100">
<img src="https://developer.nuki.io/uploads/default/optimized/2X/7/7a836b3d68f8ada7ca56208ffd7e4b1427d2def1_2_421x748.png" width="100">
<img src="https://developer.nuki.io/uploads/default/optimized/2X/8/827e90a23073751dceabced3f5d05ff95c000d7e_2_421x748.png" width="100">
<img src="https://developer.nuki.io/uploads/default/optimized/2X/8/82bd008e34c7cbc2711ceb180c6c08f792d056bd_2_421x748.png" width="100">
<img src="https://developer.nuki.io/uploads/default/optimized/2X/5/5ee1b8b288973314411775b65c4cedcab33d4317_2_421x748.png" width="100">
<img src="https://developer.nuki.io/uploads/default/optimized/2X/b/bbbb5670f5bbb206c6d4721a72f6427a15095ef2_2_421x748.png" width="100">
### 3.2 Token
We offer two ways of verifying calls to endpoints with a token:
We offer two ways of verifying calls to endpoints with a token:
| Method | Usage |
| ------------- | ------------------------------------------------------------------------------ |
| Plain token | You can use the plain token for testing and in private, secured WIFIs or VLANs. |
| Hashed token | Use if you do not want to send the plain token within your API-calls.<br><br>**Note:** Only available for the hardware bridge for now. |
#### 3.2.1 Parameters
| Name | Parameter | Values | Example |
| ------------- | --------- | --------------------- | ---------------------------------------------------------------- |
| Plain token | token | uint8[20] | 123456 |
| Timestamp | ts | YYY-MM-DDTHH:MM:SSZ | 2019-03-05T01:06:53Z |
| Random number | rnr | uint16 | 4711 |
| Hash | hash | sha256("ts,mr,token") | f52eb5ce382e356c4239f8fb4d0a87402bb95b7b3124f0762b806ad7d0d01cb6 |
sha256("2019-03-05T01:06:53Z,4711,123456") = f52eb5ce382e356c4239f8fb4d0a87402bb95b7b3124f0762b806ad7d0d01cb6
#### 3.2.2 Example calls