GEgeoadmin

Retrieve sensor parameter metadata

Changed on

Fetches the JSONLogic formula, boundaries, and version information for a specific sensor parameter.

get/sensor-parameters/config

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

dasKeystring required
Example:SOL_EXPERTS__BH12-P03__temperature

The composite DAS mapping key ("<DAS><das_sensor_alias><das_parameter_alias>"), i.e. the same value used as the Kafka message key on internal-sensor-config.

Response

Successful response containing the sensor parameter configuration.

das'SOL_EXPERTS' required

The data acquisition system (DAS) enum value this parameter is sourced from. Defined once here so both core (publisher) and pipeline (normalizer, SensorConfigCache) agree on the same vocabulary instead of duplicating it.

das_sensor_aliasstring required

The device/sensor identifier used on the DAS (sensor.das_sensor_alias). Forms the middle segment of the composite DAS mapping key.

das_parameter_aliasstring required

The field name used on the DAS for this specific measurement (sensor_parameter.das_parameter_alias). Forms the suffix of the composite DAS mapping key.

sensor_parameter_idstring uuid required

The unique identifier (UUIDv7) of the sensor parameter. Sent unchanged to the pipeline and used as the foreign key when persisting readings in TimeScaleDB, decoupled from the das/das_sensor_alias/das_parameter_alias mapping used only for inbound routing - replacing the previous brittle sensor_code-based mapping and allowing DAS-side remapping without orphaning historical readings.

formulastring required

The dynamic mathematical expression used to standardize raw readings into SI units. Must use standard infix notation and include the variable 'x' (representing the raw value).

upper_boundnumber double required

The maximum limit for this sensor parameter used for alerting.

lower_boundnumber double required

The minimum limit for this sensor parameter used for alerting.

versioninteger required

The version number of this specific sensor parameter configuration record.

Example response

{
  "das": "SOL_EXPERTS",
  "das_sensor_alias": "BH12-P03",
  "das_parameter_alias": "temperature",
  "sensor_parameter_id": "018f2e6a-7c3e-7c3e-8b3e-1a2b3c4d5e6f",
  "formula": "x * 1.8 + 32",
  "upper_bound": 150000.5,
  "lower_bound": -100,
  "version": 2
}

Changes