AeroDataBox API - Aviation and Flight API — Flight Alert API

naftiko: 1.0.0-alpha2
info:
  label: AeroDataBox API - Aviation and Flight API — Flight Alert API
  description: 'AeroDataBox API - Aviation and Flight API — Flight Alert API. 7 operations. Lead operation: AeroDataBox Get
    Web-hook Subscription Balance / FREE TIER. Self-contained Naftiko capability covering one Aerodatabox business surface.'
  tags:
  - Aerodatabox
  - Flight Alert 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-flight-alert-api
    baseUri: https://prod.api.market/api/v1/aedbx/aerodatabox
    description: AeroDataBox API - Aviation and Flight API — Flight Alert API business capability. Self-contained, no shared
      references.
    resources:
    - name: subscriptions-balance
      path: /subscriptions/balance
      operations:
      - name: getbalance
        method: GET
        description: AeroDataBox Get Web-hook Subscription Balance / FREE TIER
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-balance-refill
      path: /subscriptions/balance/refill
      operations:
      - name: refillbalance
        method: POST
        description: AeroDataBox Refill Web-hook Subscription Balance / TIER 1
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: subscriptions-webhook
      path: /subscriptions/webhook
      operations:
      - name: getwebhooklist
        method: GET
        description: AeroDataBox List Web-hook Subscriptions / FREE TIER
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-webhook-subjectType-subjectId
      path: /subscriptions/webhook/{subjectType}/{subjectId}
      operations:
      - name: subscribewebhook
        method: POST
        description: AeroDataBox Create Web-hook Subscription / TIER 4
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: subjectType
          in: path
          type: string
          description: Subject type
        - name: subjectId
          in: path
          type: string
          description: "Subject ID. If `subjectType` is: \r"
          required: true
        - name: useCredits
          in: query
          type: boolean
          description: "THIS IS A TEMPORARY MIGRATION PARAMETER FOR EASIER TRANSITION. \r"
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: subscriptions-webhook-subscriptionId
      path: /subscriptions/webhook/{subscriptionId}
      operations:
      - name: getwebhook
        method: GET
        description: AeroDataBox Get Web-hook Subscription / FREE TIER
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: subscriptionId
          in: path
          type: string
          description: Subscription ID
          required: true
      - name: unsubscribewebhook
        method: DELETE
        description: AeroDataBox Remove Web-hook Subscription / FREE TIER
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: subscriptionId
          in: path
          type: string
          description: Subscription ID
          required: true
    - name: subscriptions-webhook-subscriptionId-refresh
      path: /subscriptions/webhook/{subscriptionId}/refresh
      operations:
      - name: refreshwebhook
        method: PATCH
        description: AeroDataBox Refresh Web-hook Subscription (DEPRECATED) / TIER 4
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: subscriptionId
          in: path
          type: string
          description: Subscription ID
          required: true
        - name: useCredits
          in: query
          type: boolean
          description: "THIS IS A TEMPORARY MIGRATION PARAMETER FOR EASIER TRANSITION. \r"
  exposes:
  - type: rest
    namespace: aerodatabox-flight-alert-api-rest
    port: 8080
    description: REST adapter for AeroDataBox API - Aviation and Flight API — Flight Alert API. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions/balance
      name: subscriptions-balance
      description: REST surface for subscriptions-balance.
      operations:
      - method: GET
        name: getbalance
        description: AeroDataBox Get Web-hook Subscription Balance / FREE TIER
        call: aerodatabox-flight-alert-api.getbalance
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/balance/refill
      name: subscriptions-balance-refill
      description: REST surface for subscriptions-balance-refill.
      operations:
      - method: POST
        name: refillbalance
        description: AeroDataBox Refill Web-hook Subscription Balance / TIER 1
        call: aerodatabox-flight-alert-api.refillbalance
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/webhook
      name: subscriptions-webhook
      description: REST surface for subscriptions-webhook.
      operations:
      - method: GET
        name: getwebhooklist
        description: AeroDataBox List Web-hook Subscriptions / FREE TIER
        call: aerodatabox-flight-alert-api.getwebhooklist
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/webhook/{subjecttype}/{subjectid}
      name: subscriptions-webhook-subjecttype-subjectid
      description: REST surface for subscriptions-webhook-subjectType-subjectId.
      operations:
      - method: POST
        name: subscribewebhook
        description: AeroDataBox Create Web-hook Subscription / TIER 4
        call: aerodatabox-flight-alert-api.subscribewebhook
        with:
          subjectType: rest.subjectType
          subjectId: rest.subjectId
          useCredits: rest.useCredits
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/webhook/{subscriptionid}
      name: subscriptions-webhook-subscriptionid
      description: REST surface for subscriptions-webhook-subscriptionId.
      operations:
      - method: GET
        name: getwebhook
        description: AeroDataBox Get Web-hook Subscription / FREE TIER
        call: aerodatabox-flight-alert-api.getwebhook
        with:
          subscriptionId: rest.subscriptionId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: unsubscribewebhook
        description: AeroDataBox Remove Web-hook Subscription / FREE TIER
        call: aerodatabox-flight-alert-api.unsubscribewebhook
        with:
          subscriptionId: rest.subscriptionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/webhook/{subscriptionid}/refresh
      name: subscriptions-webhook-subscriptionid-refresh
      description: REST surface for subscriptions-webhook-subscriptionId-refresh.
      operations:
      - method: PATCH
        name: refreshwebhook
        description: AeroDataBox Refresh Web-hook Subscription (DEPRECATED) / TIER 4
        call: aerodatabox-flight-alert-api.refreshwebhook
        with:
          subscriptionId: rest.subscriptionId
          useCredits: rest.useCredits
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aerodatabox-flight-alert-api-mcp
    port: 9090
    transport: http
    description: MCP adapter for AeroDataBox API - Aviation and Flight API — Flight Alert API. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: aerodatabox-get-web-hook-subscription
      description: AeroDataBox Get Web-hook Subscription Balance / FREE TIER
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-flight-alert-api.getbalance
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-refill-web-hook-subscription
      description: AeroDataBox Refill Web-hook Subscription Balance / TIER 1
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: aerodatabox-flight-alert-api.refillbalance
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-list-web-hook-subscriptions
      description: AeroDataBox List Web-hook Subscriptions / FREE TIER
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-flight-alert-api.getwebhooklist
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-create-web-hook-subscription
      description: AeroDataBox Create Web-hook Subscription / TIER 4
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: aerodatabox-flight-alert-api.subscribewebhook
      with:
        subjectType: tools.subjectType
        subjectId: tools.subjectId
        useCredits: tools.useCredits
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-get-web-hook-subscription-2
      description: AeroDataBox Get Web-hook Subscription / FREE TIER
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aerodatabox-flight-alert-api.getwebhook
      with:
        subscriptionId: tools.subscriptionId
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-remove-web-hook-subscription
      description: AeroDataBox Remove Web-hook Subscription / FREE TIER
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: aerodatabox-flight-alert-api.unsubscribewebhook
      with:
        subscriptionId: tools.subscriptionId
      outputParameters:
      - type: object
        mapping: $.
    - name: aerodatabox-refresh-web-hook-subscription
      description: AeroDataBox Refresh Web-hook Subscription (DEPRECATED) / TIER 4
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: aerodatabox-flight-alert-api.refreshwebhook
      with:
        subscriptionId: tools.subscriptionId
        useCredits: tools.useCredits
      outputParameters:
      - type: object
        mapping: $.