diff --git a/Documents-Bridge-API.md b/Documents-Bridge-API.md index 71ad38c..9ac9bf6 100644 --- a/Documents-Bridge-API.md +++ b/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) + + + + + + + + ### 3.2 Token -We offer two ways of verifying calls to endpoints with a token: \ No newline at end of file +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.

**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 \ No newline at end of file