aerops airport API

The aerops airport API provides an interface for creating articles and baskets to be paid by pilots using the aerops app.
The API can be used to:
  • get aircraft information.
  • create articles in aerops.
  • create baskets with articles which can be paid by pilots with the aerops app.
  • keep track of articles paid with aerops.

Overview

external api

  1. user requests payment with app.
  2. your airport software gets request with details about aircraft and pilot.
  3. your airport software creates a basket for this pilot.
  4. pilot is notified and can pay basket in the app.

Endpoints

Endpoint for aircraft https://avdb.aerops.com/public/aircraft.
Endpoint for articles https://avdb.aerops.com/public/articles.
Endpoint for payment-requests https://avdb.aerops.com/public/payment-request.
Endpoint for basket https://avdb.aerops.com/public/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.

GET aircraft

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

GET/POST articles

GET: https://avdb.aerops.com/public/articles/1
POST: https://avdb.aerops.com/public/articles
price corrensponds to the gross price. Set taxRate accordingly.
Set category to 8 for fuel articles. Only fuel can be bought in decimal quantities.
IDs for category:

ID Description
5 landing fee
6 parking fee
7 handling fee
8 fuel articles (can be bought in decimal quanties)
null everything else

PUT articles

PUT: https://avdb.aerops.com/public/articles/1
All article fields except id can be updated.

DELETE articles

DELETE: https://avdb.aerops.com/public/articles/1
Delete article from aerops.

GET payment-request

GET: https://avdb.aerops.com/public/payment-request
Example GET all payment-requests for the selected date: public/payment-request?date=2018-07-18

POST basket

POST: https://avdb.aerops.com/public/basket

GET basket

GET: https://avdb.aerops.com/public/basket
status indicates whether this basket has been paid. limit and offset can be used to filter the results.
Example: /public/basket?limit=2&offset=1

DELETE basket

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

Changelog

14.08.2018
  • Added /basket and /payment-request endpoints.
06.06.2018
  • Added /articles/{id} DELETE functionality.
  • Removed aircraft POST. This can be done through the aerops app from now on.