Info¶

This route has no version prefix so it is always reachable, regardless of which API version the client is using.

Default port

This service uses port 11395 by default. You can change the port if needed. See Changing the HTTP port for instructions.

Security note

The Dracal Device Service HTTP server only accepts local connections to the REST JSON API. Remote connections are rejected for security reasons.

Get Service Information¶

Request¶

GET http://localhost:11395/dracal-service-info

Returns information about the Dracal Device Service, including its name, status, and version.

Authentication: None required

Response Format: JSON

Query Parameters:

Parameter	Type	Default	Description
`pretty`	boolean	`false`	When `true`, the response JSON is indented (pretty-printed). Omitting the parameter or setting it to `false` returns minified JSON.

Response¶

service_name (string): Name of the service
status (string): Current status (ok or error status)
version (object): Version information
- major (integer): Major version number
- minor (integer): Minor version number
- patch (integer): Patch version number
- tag (string): Release tag
- tweak (integer): Tweak version number

Example¶

{
  "service_name": "dracal-device-service",
  "status": "ok",
  "version": {
    "major": 3,
    "minor": 6,
    "patch": 0,
    "tag": "v3.6.0",
    "tweak": 0
  }
}