BLbluestaq
Site

POST /udl/airfieldstatus

Changed on

Service operation to take a single airfield status record as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism.

Request

  • Base URL
    https://unifieddatalibrary.com
  • URL
    https://unifieddatalibrary.com/udl/airfieldstatus
  • 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.

idAirfieldstring required

Unique identifier of the Airfield for which this status is referencing.

altAirfieldIdstring

Alternate airfield identifier provided by the source.

surveyDatestring date-time

The date the airfield survey was performed, in ISO 8601 UTC format with millisecond precision.

reviewedBystring

The name of the person who reviewed the airfield survey.

reviewedDatestring date-time

The date the airfield survey was reviewed, in ISO 8601 UTC format with millisecond precision.

approvedBystring

The name of the person who approved the airfield survey review.

approvedDatestring date-time

The date that survey review changes were approved for this airfield, in ISO 8601 UTC format with millisecond precision.

passengerServiceMOGinteger

Maximum on ground (MOG) number of high-reach/wide-body passenger aircraft that can be serviced simultaneously based on spacing and manpower at the time of status.

fleetServiceMOGinteger

Maximum on ground (MOG) number of fleet aircraft that can be serviced simultaneously based on spacing and manpower at the time of status.

cargoMOGinteger

Maximum on ground (MOG) number of high-reach/wide-body cargo aircraft that can be serviced simultaneously based on spacing and manpower at the time of status.

fuelMOGinteger

Maximum on ground (MOG) number of aircraft that can be simultaneously refueled based on spacing and manpower at the time of status.

fuelTypesstring[]

Array of fuel types available at the airfield. This array must be the same length as fuelQtys.

fuelQtysnumber[]

Array of quantities for each fuel type at the airfield, in kilograms. The values in this array must correspond to the position index in fuelTypes. This array must be the same length as fuelTypes.

mxMOGinteger

Maximum on ground (MOG) number of aircraft that can be simultaneously ground handled for standard maintenance based on spacing and manpower at the time of status.

operatingMOGinteger

Maximum on ground (MOG) number of aircraft due to items not directly related to the airfield infrastructure or aircraft servicing capability based on spacing and manpower at the time of status.

numCOGinteger

The number of aircraft that are currently on ground (COG) at the airfield.

wideWorkingMOGinteger

Maximum on ground (MOG) number of working wide-body aircraft based on spacing and manpower at the time of status. Additional information about this field as it pertains to specific aircraft type may be available in an associated SiteOperations record.

wideParkingMOGinteger

Maximum on ground (MOG) number of parking wide-body aircraft based on spacing and manpower at the time of status. Additional information about this field as it pertains to specific aircraft type may be available in an associated SiteOperations record.

narrowWorkingMOGinteger

Maximum on ground (MOG) number of working narrow-body aircraft based on spacing and manpower at the time of status.

narrowParkingMOGinteger

Maximum on ground (MOG) number of parking narrow-body aircraft based on spacing and manpower at the time of status.

mheTypesstring[]

Array of material handling equipment types at the airfield. This array must be the same length as mheQtys.

mheQtysinteger[]

Array of quantities for each material handling equipment types at the airfield. The values in this array must correspond to the position index in mheTypes. This array must be the same length as mheTypes.

medCapstring

The level of medical support and capabilities available at the airfield.

arffCatstring

The category of aircraft rescue and fire fighting (ARFF) services that are currently available at the airfield. Entries should include the code (FAA or ICAO) and the category.

gseTimeinteger

The expected time to receive ground support equipment (e.g. power units, air units, cables, hoses, etc.), in minutes.

priRwyNumstring

The number or ID of primary runway at the airfield.

rwyCondReadinginteger

The primary runway condition reading value used for determining runway braking action, from 0 to 26. A value of 0 indicates braking action is poor or non-existent, where a value of 26 indicates braking action is good.

rwyFrictionFactorinteger

The primary runway friction factor which is dependent on the surface friction between the tires of the aircraft and the runway surface, from 0 to 100. A lower number indicates less friction and less braking response.

rwyMarkingsstring[]

Array of markings currently on the primary runway.

messagestring

Description of the current status of the airfield.

priFreqnumber double

The primary frequency which the airfield is currently operating, in megahertz.

slotTypesReqstring[]

Array of slot types that an airfield requires a particular aircraft provide in order to consume a slot at this location.

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.

sourceDLstring

The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.

sourcestring required

Source of the data.

originstring

Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.

origNetworkstring

The originating source network on which this record was created, auto-populated by the system.

dataMode'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE' required

Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data:

REAL: Data collected or produced that pertains to real-world objects, events, and analysis.

TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics.

EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data.

SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

Example request

{
  "id": "be831d39-1822-da9f-7ace-6cc5643397dc",
  "classificationMarking": "U",
  "idAirfield": "3136498f-2969-3535-1432-e984b2e2e686",
  "altAirfieldId": "AIRFIELD-ID",
  "surveyDate": "2023-01-01T12:00:00.123Z",
  "reviewedBy": "Jane Doe",
  "reviewedDate": "2024-01-01T00:00:00.123Z",
  "approvedBy": "John Smith",
  "approvedDate": "2024-01-01T16:00:00.123Z",
  "passengerServiceMOG": 5,
  "fleetServiceMOG": 4,
  "cargoMOG": 8,
  "fuelMOG": 9,
  "fuelTypes": [
    "JP-8",
    "Jet A",
    "AVGAS"
  ],
  "fuelQtys": [
    263083.6,
    286674.9,
    18143.69
  ],
  "mxMOG": 3,
  "operatingMOG": 4,
  "numCOG": 2,
  "wideWorkingMOG": 3,
  "wideParkingMOG": 7,
  "narrowWorkingMOG": 4,
  "narrowParkingMOG": 5,
  "mheTypes": [
    "30k",
    "AT",
    "60k"
  ],
  "mheQtys": [
    1,
    3,
    1
  ],
  "medCap": "Large Field Hospital",
  "arffCat": "FAA-A",
  "gseTime": 10,
  "priRwyNum": "35R",
  "rwyCondReading": 23,
  "rwyFrictionFactor": 10,
  "rwyMarkings": [
    "Aiming Point",
    "Threshold"
  ],
  "message": "Status message about the airfield.",
  "priFreq": 123.45,
  "slotTypesReq": [
    "PARKING",
    "WORKING",
    "LANDING"
  ],
  "createdAt": "2022-01-01T16:00:00.123Z",
  "createdBy": "some.user",
  "sourceDL": "AXE",
  "source": "Bluestaq",
  "origin": "THIRD_PARTY_DATASOURCE",
  "origNetwork": "OPS1",
  "dataMode": "TEST"
}

Response

Success

Changes

  • 75f764c843a9Revision changes
    • breaking

      request body became required

    • warning

      the / request property's maxLength was set to 32

    • warning

      the / request property's maxLength was set to 32

    • warning

      the / request property's maxLength was set to 64

    • warning

      the / request property's maxLength was set to 64

    • info

      api operation id create_11 removed and replaced with

    • info

      the endpoint scheme security BasicAuth was removed from the API

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

Some revisions have not been checked yet.