The following pages and posts are tagged with
| Title | Type | Excerpt |
|---|---|---|
| Conditional requests on things | Page | Conditional requests let you apply commands to Things only when specific conditions about the Thing’s current state are met. TL;DR: Use the condition header with an RQL expression to make updates conditional on the Thing’s current state. You can also use If-Match/If-None-Match... |
| HTTP API Concepts | Page | The Ditto HTTP API follows REST conventions and maps the JSON structure of digital twins directly to API endpoints, giving you fine-grained access to every piece of twin data. TL;DR: The HTTP API auto-generates endpoints from your Thing’s JSON structure, supports partial reads/writes, merge updates via <code class="language-plaintext... |
| HTTP API Messages | Page | You send messages to and from Things and Features through the HTTP API, enabling command-and-control communication with devices. TL;DR: Send a POST to a Thing’s or Feature’s inbox to send it a message, or to its outbox to send a message from... |
| API Overview | Page | Ditto provides multiple interfaces for interacting with digital twins, ranging from a REST-like HTTP API to persistent WebSocket connections, Server-Sent Events, and a connectivity layer for integrating external messaging systems. TL;DR: You interact with Ditto through its HTTP API for request/response operations, the WebSocket API for real-time bidirectional... |
| Cloud Events Binding | Page | You use the Cloud Events endpoint to ingest data into Ditto using the standardized CloudEvents HTTP Protocol Binding (v1.0), enabling integration with CloudEvents-aware platforms like Knative. TL;DR: Send CloudEvents-formatted HTTP requests to /api/2/cloudevents with Ditto Protocol JSON as the payload and ditto: as... |
| WebSocket Binding | Page | You use the WebSocket binding to send Ditto Protocol messages over a persistent, duplex connection – enabling real-time change notifications, bidirectional messaging, and live device interaction. TL;DR: Connect to ws://localhost:8080/ws/2, send Ditto Protocol JSON messages, and subscribe to events, messages, or live commands using plain-text... |
| HTTP API Search | Page | You search for Things using RQL expressions against the HTTP search endpoint, with support for filtering, sorting, paging, and field selection. TL;DR: Send GET or POST requests to /api/2/search/things with filter, option, fields, and <code... |
| Server-Sent Events (SSE) | Page | You use Server-Sent Events (SSE) to receive real-time change notifications for digital twins and to stream search results – all through a simple, unidirectional HTTP connection. TL;DR: Open an SSE connection to /api/2/things with Accept: text/event-stream to stream change notifications, or to <code class="language-plaintext... |
| WoT Tooling: Code Generation and OpenAPI from Thing Models | Post | Eclipse Ditto’s W3C WoT (Web of Things) integration lets you reference Thing Models in Thing Definitions, generate Thing Descriptions, and create Thing skeletons at runtime. Alongside that, the ditto-wot-tooling project provides build-time and CLI tools to generate Kotlin code and OpenAPI specifications from the same WoT... |
| Support conditional requests for live messages | Post | With the upcoming release of Eclipse Ditto version 3.1.0 it will be possible to process live messages based on conditions. Conditional live messages Ditto now supports conditional message sending based on a specified condition in the request. This functionality can be used via the HTTP API with an HTTP... |
| W3C WoT (Web of Things) integration | Post | The upcoming Eclipse Ditto version 2.4.0 will add support for W3C WoT (Web of Things) integration by referencing WoT Thing Model in Ditto managed twins describing the Things’ capabilities. Using this integration, Ditto managed digital twins can be linked to WoT “Thing Models” from which Ditto can create WoT... |
| Conditionally direct retrieving API calls to either live or twin channel | Post | After the added option to target the live channel by adding the channel=live to HTTP requests (see also blog post about “HTTP live channel”), Eclipse Ditto version 2.3.0 will in addition support to define a live channel condition, which, when evaluating to true,... |
| Sending live channel commands via HTTP to devices | Post | The upcoming release of Eclipse Ditto version 2.3.0 will support sending commands via the HTTP API directly to devices using the live channel by just adding the channel=live query parameter to the same HTTP API request which would target the twin. HTTP Live channel Ditto... |
| Support conditional requests for things resources | Post | With the upcoming release of Eclipse Ditto version 2.1.0 it will be possible to execute conditional requests on things and their sub-resources. Conditional requests for things resources Ditto now supports conditional requests on things and all of its sub-resources based on a specified condition in the request. This functionality... |
| Support merge functionality for things resources | Post | With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to merge existing things and their subresources. Merge functionality for things resources Ditto now supports merging of existing things and all of its subresources with the provided payload in the request. This can be done by... |