aerops airport API

The aerops airport API provides an interface for creating baskets to be paid by pilots using the aerops app.

Endpoints

Endpoint for aircraft https://avdb.aerops.com/public/aircraft.
Endpoint for basket https://avdb.aerops.com/public/v2/airport/basket.

Authentication

All requests use Basic Authentication over HTTPS. API credentials are displayed in aerops GAT.
Contact info@aerops.com to get an account for your airport.
Full API specification.

Workflow

Pilot initiates payment via app

  1. Your airport software gets request with details about aircraft and pilot. status: pilot_requested
  2. Your airport software updates the basket for this pilot. status: airport_requested
  3. Pilot is notified and can pay basket in the app. status: paid

Airport initiates payment via GAT / API

  1. Basket is created in GAT/API for pilot to pay. status: airport_requested
  2. Pilot is notified and can pay basket in the app. status: paid
external api

GET aircraft

GET: https://avdb.aerops.com/public/aircraft/D-XXXX

GET basket

GET: https://avdb.aerops.com/public/v2/airport/basket
status indicates whether this basket has been paid. The result can be filtered by status, limit and offset.
Example: /public/v2/airport/basket?limit=2&offset=1
Example: /public/v2/airport/basket?status=airport_requested,pilot_requested

PUT basket

PUT: https://avdb.aerops.com/public/v2/airport/basket/4
Baskets with status="pilot_requested" can be updated with articles for the pilot to pay. PUT automatically changes the baskets status to airport_requested and notifies the pilot/app. Prices are always displayed as gross prices with tax included.

DELETE basket

DELETE: https://avdb.aerops.com/public/v2/airport/basket/1
Delete basket specified by ID. Only baskets with status="pilot_requested" or status="airport_requested" can be deleted.

category values:
Value Description
landing Landing fee
parking Parking fee
approach Approach fee
fueling Fuel articles (only articles with category "fueling" can use decimal quantities)
other everything else


status values:
Value Description
pilot_requested Pilot has payment. Basket can now be filled by airport software.
airport_requested Basket has been updated by airport software. Can now be paid by the pilot via the app.
pilot_confirmed App as received the basket and is about to pay it. Changes to basket are no longer possible.
paid Basket has been paid by pilot. Updates to the basket are no longer possible.


aircraftClass values:
id description
1 Aircraft
2 Rotorcraft
3 Airship
4 Sailplane
4 Glider
5 Motorglider
6 Balloon
7 Ultralight

aircraftCategory is reserved for future use.

Changelog

23.02.2019
  • Updated description for v2 basket api.