Skip to content

Commit

Permalink
fixed wording in httpapi-overview.md docs about channel
Browse files Browse the repository at this point in the history
Signed-off-by: Thomas Jaeckle <thomas.jaeckle@bosch.io>
  • Loading branch information
thjaeckle committed Nov 24, 2021
1 parent 375333e commit 32503db
Showing 1 changed file with 4 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,13 @@ If you have any feedback on how to improve at that point, Ditto's developer team

Ditto supports two types of communication channels: `twin` and `live`.

The `twin` channel is used to communicate with the **digital twin** representation of a device.
The `live` channel can be used to communicate directly with an actual device.
The `twin` channel is used to communicate with the persisted **digital twin** representation of a device.
The `live` channel can be used to communicate directly with an actual device.

In case the `live` channel is used, the device itself is responsible for answering the command/message.
If no response is returned, the request will result in a timeout, and Ditto will respond with `408 Request Timeout`.
This timeout can be set with the `timeout` parameter. If no `timeout` parameter is set, the default of `10s` is used to
wait for response of the device.
wait for response of the device.
When routing live commands to devices, Ditto is doing an [authorization check](basic-auth.html) based on the policy
of the thing. Ditto also filters responses based on that policy.

Expand Down

0 comments on commit 32503db

Please sign in to comment.