API - Application Programming Interface
WHAT'S AN API?
API stands for "Application Programming Interface" and enables a developper to access data of AVIATION-FUEL-PRICES.COM, for use in their application or service. The API, as the name says, provides an interface for data exchange, that allows communication between diffenren entities, which may be programmed in totally different languages.
The types of services the developper provides, could for example be computer or smart phone applications, as well as websites.
WHY AN API?
The data collected by AVIATION-FUEL-PRICES.COM bases to a large extent on input provided by users. We believe that there are other awesome services for pilots out there that may even enhance their user experience with the implementation of our data. And that's why we share our data for free under a Creative Commons license.
When all EFB apps and flight planning services collect fuel price data and only provide them to their own users, there will never be a nearly complete picture available anywhere. It is, therefore, desirable to centralice the data collection and make it accessable to everyone, who has a legitimate interest. That way other developers can focus more on the quality of their services, instead of also putting resources into collecting fuel prices.
HOW IT WORKS
If you are a developper and would like to use our API, you'll need to create a developper account with us. For that, please get in touch via the contact form.
Information on how to use the AVIATION-FUEL-PRICES.COM API is collected in the wiki section below.
This work is licensed under CC BY-NC-ND 4.0
API wiki
General
The API is accessable under "https://api.aviation-fuel-prices.com/v1.0/"
The use of the AVIATION-FUEL-PRICES.COM API requires an API-key. This key is unique to you and is required to authenticate yourself when accessing the API. Your API-key is generated for you upon opening a developer account. The key must be attached to every request you put to the API "...?api_key=XYZ"
Request latest prices at an airport
With the following command, you can request the lastes price information for any available fuel type at any airport in the database. You address your request to "latest-prices-at/" and provide an ICAO code after the slash.
As response, you'll receive an array "prices", which contains arrays for each available fuel type.
JSON response:
Request latest price updates of the past days
With the following command, you can request the lastes price information for any airport in the database that has been updated or verified in the past days. You address your request to "latest-updates/" and provide the maximum number of days you would like to look in the past after the slash (e.g. 10 provides you with a list of all updated or verified prices from the last ten days). Note: the maximum mumber of days you can request in the past is 30.
As response, you'll receive an array "prices", which contains arrays for each available fuel type.
JSON response: