dc3-driver-http is the HTTP REST client driver of the IoT DC3 platform. It uses Spring WebFlux WebClient to call configured REST endpoints, reads point values from JSON responses (with simple JSON path extraction), and writes values via request body templates containing a ${value} placeholder.

Module Information

Group ID: io.github.pnoker
Artifact ID: dc3-driver-http
Version: 2026.5.22
Driver Name: HTTP REST Client Driver

Driver Attributes (Device-level)

Attribute	Description
Base URL	Base URL for API requests (e.g. https://api.example.com)
Method	Default HTTP method (GET, POST, PUT, DELETE)
Headers	Custom headers as JSON (e.g. {"Authorization":"Bearer xxx"})
Timeout	Request timeout in milliseconds

Point Attributes

Attribute	Description
Path	API path (e.g. /api/v1/sensor/{id})
Method	HTTP method override for this point
Body Template	Request body template with ${value} placeholder
Response Path	JSON path to extract value (e.g. $.data.temperature)

Command Attributes (write)

Attribute	Description
Path	API path for command
Method	HTTP method for command

Prerequisites

A reachable HTTP/REST endpoint that the driver can call as configured via the device's Base URL and point paths.

Running Locally

1. Start Infrastructure and Center Services

podman compose -f dc3/docker-compose-db.yml up -d
java -jar dc3-center/dc3-center-manager/target/dc3-center-manager.jar

2. Build and Run

mvn -s .mvn/settings.xml clean package
java -jar dc3-driver/dc3-driver-http/target/dc3-driver-http.jar

dc3-common-driver — Driver SDK for registration, scheduling, and RabbitMQ integration

License

Licensed under the GNU Affero General Public License v3.0 (AGPL 3.0)

README.md

DC3 Driver HTTP

Overview