AeroDataBox API - Aviation and Flight API — Miscellaneous API

naftiko: 1.0.0-alpha2
info:
  label: AeroDataBox API - Aviation and Flight API — Miscellaneous API
  description: 'AeroDataBox API - Aviation and Flight API — Miscellaneous API. 4 operations. Lead operation: AeroDataBox Distance
    and Flight Time Between Airports / TIER 2. Self-contained Naftiko capability covering one Aerodatabox business surface.'
  tags:
  - Aerodatabox
  - Miscellaneous API
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AERODATABOX_API_KEY: AERODATABOX_API_KEY
capability:
  consumes:
  - type: http
    namespace: aerodatabox-miscellaneous-api
    baseUri: https://prod.api.market/api/v1/aedbx/aerodatabox
    description: AeroDataBox API - Aviation and Flight API — Miscellaneous API business capability. Self-contained, no shared
      references.
    resources:
    - name: airports-codeType-codeFrom-distance-time-codeTo
      path: /airports/{codeType}/{codeFrom}/distance-time/{codeTo}
      operations:
      - name: getairportdistancetime
        method: GET
        description: AeroDataBox Distance and Flight Time Between Airports / TIER 2
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: codeType
          in: path
          type: string
          description: Type of code to search airport by (`iata` or `icao`)
        - name: codeFrom
          in: path
          type: string
          description: "If `codeType` is:\r"
          required: true
        - name: codeTo
          in: path
          type: string
          description: "If `codeType` is:\r"
          required: true
        - name: aircraftName
          in: query
          type: string
          description: "Aircraft type name (free text). \r"
        - name: flightTimeModel
          in: query
          type: string
          description: "Model of calculation of the flight time. Default is <a href=\"#model-ModelFlightTimeEnum\"></a>\r"
    - name: airports-codeType-code-time-local
      path: /airports/{codeType}/{code}/time/local
      operations:
      - name: getairportlocaltime
        method: GET
        description: AeroDataBox Current Local Time at the Airport / TIER 1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: codeType
          in: path
          type: string
          description: Type of code to search airport by (`iata` or `icao`)
        - name: code
          in: path
          type: string
          description: "If `codeType` is:\r"
          required: true
    - name: airports-codeType-code-time-solar
      path: /airports/{codeType}/{code}/time/solar
      operations:
      - name: getairportsolartimesolartimecurrent
        method: GET
        description: AeroDataBox Solar and Day Time at the Airport / TIER 1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: codeType
          in: path
          type: string
          description: Type of code to search airport by (`iata` or `icao`)
        - name: code
          in: path
          type: string
          description: "If `codeType` is:\r"
          required: true
    - name: airports-codeType-code-time-solar-dateLocal
      path: /airports/{codeType}/{code}/time/solar/{dateLocal}
      operations:
      - name: getairportsolartimesolartimespecificdate
        method: GET
        description: AeroDataBox Solar and Day Time at the Airport / TIER 1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: codeType
          in: path
          type: string
          description: Type of code to search airport by (`iata` or `icao`)
        - name: code
          in: path
          type: string
          description: "If `codeType` is:\r"
          required: true
        - name: dateLocal
          in: path
          type: string
          description: "The moment of time which solar data is request for (local time, format: YYYY-MM-DDTHH:mm). \r"
          required: true
  exposes:
  - type: rest
    namespace: aerodatabox-miscellaneous-api-rest
    port: 8080
    description: REST adapter for AeroDataBox API - Aviation and Flight API — Miscellaneous API. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/airports/{codetype}/{codefrom}/distance-time/{codeto}
      name: airports-codetype-codefrom-distance-time-codeto
      description: REST surface for airports-codeType-codeFrom-distance-time-codeTo.
      operations:
      - method: GET
        name: getairportdistancetime
        description: AeroDataBox Distance and Flight Time Between Airports / TIER 2
        call: aerodatabox-miscellaneous-api.getairportdistancetime
        with:
          codeType: rest.codeType
          codeFrom: rest.codeFrom
          codeTo: rest.codeTo
          aircraftName: rest.aircraftName
          flightTimeModel: rest.flightTimeModel
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/airports/{codetype}/{code}/time/local
      name: airports-codetype-code-time-local
      description: REST surface for airports-codeType-code-time-local.
      operations:
      - method: GET
        name: getairportlocaltime
        description: AeroDataBox Current Local Time at the Airport / TIER 1
        call: aerodatabox-miscellaneous-api.getairportlocaltime
        with:
          codeType: rest.codeType
          code: rest.code
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/airports/{codetype}/{code}/time/solar
      name: airports-codetype-code-time-solar
      description: REST surface for airports-codeType-code-time-solar.
      operations:
      - method: GET
        name: getairportsolartimesolartimecurrent
        description: AeroDataBox Solar and Day Time at the Airport / TIER 1
        call: aerodatabox-miscellaneous-api.getairportsolartimesolartimecurrent
        with:
          codeType: rest.codeType
          code: rest.code
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/airports/{codetype}/{code}/time/solar/{datelocal}
      name: airports-codetype-code-time-solar-datelocal
      description: REST surface for airports-codeType-code-time-solar-dateLocal.
      operations:
      - method: GET
        name: getairportsolartimesolartimespecificdate
        description: AeroDataBox Solar and Day Time at the Airport / TIER 1
        call: aerodatabox-miscellaneous-api.getairportsolartimesolartimespecificdate
        with:
          codeType: rest.codeType
          code: rest.code
          dateLocal: rest.dateLocal
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aerodatabox-miscellaneous-api-mcp
    port: 9090
    transport: http
    description: MCP adapter for AeroDataBox API - Aviation and Flight API — Miscellaneous API. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: aerodatabox-distance-and-flight-time
      description: AeroDataBox Distance and Flight Time Between Airports / TIER 2
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-miscellaneous-api.getairportdistancetime
      with:
        codeType: tools.codeType
        codeFrom: tools.codeFrom
        codeTo: tools.codeTo
        aircraftName: tools.aircraftName
        flightTimeModel: tools.flightTimeModel
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-current-local-time-airport
      description: AeroDataBox Current Local Time at the Airport / TIER 1
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-miscellaneous-api.getairportlocaltime
      with:
        codeType: tools.codeType
        code: tools.code
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-solar-and-day-time
      description: AeroDataBox Solar and Day Time at the Airport / TIER 1
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-miscellaneous-api.getairportsolartimesolartimecurrent
      with:
        codeType: tools.codeType
        code: tools.code
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-solar-and-day-time-2
      description: AeroDataBox Solar and Day Time at the Airport / TIER 1
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-miscellaneous-api.getairportsolartimesolartimespecificdate
      with:
        codeType: tools.codeType
        code: tools.code
        dateLocal: tools.dateLocal
      outputParameters:
      - type: object
        mapping: $.