BLbluestaq
Sensor

POST /udl/sensorstaging

Changed on

Service operation to take a single SensorStaging record as a POST body and ingest into the staging database. This API allows users to create, manage, and review SensorStaging records in a staging environment before their incorporation into the production UDL. It supports workflows involving validation, review, and approval of sensor data to ensure consistency, compliance, and data quality. A specific role is required to perform this service operation. Please contact the UDL team for assistance.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/sensorstaging
  • Auth
    none declared

Request body

idstring

Unique identifier of the record, auto-generated by the system.

classificationMarkingstring required

Classification marking of the data in IC/CAPCO Portion-marked format.

locationCountrystring

The DoD Standard Country Code designator for the country or political entity to which the sensor equipment geographic coordinates reside. This value is typically the ISO 3166 Alpha-2 two-character country code, however it can also represent various consortiums that do not appear in the ISO document. The code must correspond to an existing country in the UDL’s country API. Call udl/country/{code} to get any associated FIPS code, ISO Alpha-3 code, or alternate code values that exist for the specified country code.

ownerCountrystring

The DoD Standard Country Code designator for the country or political entity owning the sensor. This value is typically the ISO 3166 Alpha-2 two-character country code, however it can also represent various consortiums that do not appear in the ISO document. The code must correspond to an existing country in the UDL’s country API. Call udl/country/{code} to get any associated FIPS code, ISO Alpha-3 code, or alternate code values that exist for the specified country code.

sensorNamestring required

Unique name of this sensor.

shortNamestring

Optional short or abbreviated name of this sensor.

sensorNumberinteger

Number assigned to this sensor. Since there is no authoritative numbering scheme, these numbers sometimes collide across sensors (especially commercial sensors). It is therefore not a unique identifier.

latnumber double

WGS-84 latitude of the sensor, in degrees. -90 to 90 degrees (negative values south of equator).

lonnumber double

WGS-84 longitude of the sensor, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).

altitudenumber double

Sensor altitude relative to WGS-84 ellipsoid, in meters. Positive values indicate a sensor height above ellipsoid, and negative values indicate a sensor height below ellipsoid.

sensorObservationTypestring

The observation measurement type produced by this sensor.

sensorTypestring

The specific sensor type and/or surveillance capability of this sensor.

createdAtstring date-time

Time the row was created in the database, auto-populated by the system.

createdBystring

Application user who created the row in the database, auto-populated by the system.

sourcestring required

Source of the data.

Example request

{
  "id": "ad88770b-d824-443f-bdce-5f9e3fa500a9",
  "classificationMarking": "U",
  "locationCountry": "UA",
  "ownerCountry": "UA",
  "sensorName": "SENSOR_NAME",
  "shortName": "SNR-1",
  "sensorNumber": 1234,
  "lat": 48.6732,
  "lon": 22.8455,
  "altitude": 157.543,
  "sensorObservationType": "5",
  "sensorType": "Space Borne",
  "createdAt": "2025-03-05T16:00:00.123Z",
  "createdBy": "some.user",
  "source": "Bluestaq"
}

Response

Success

Changes

Some revisions have not been checked yet.