Authentication during testing
During the test phase, you can use our API without authentication. However, we do check how many requests a client does, so if you rank up a lot of usage you will get a
403 error for reaching the test quota.
If you reach your quota during testing, you can request a free test API key.
Unauthenticated calls cannot submit changes, but only retrieve data using the
Unmetered and always free calls
There are some endpoints that are unmetered and always free. These are all grouped under the
api.aviowiki.com/free space, for example
You can make as many calls as you want to these, both for personal and commercial use.
Authentication in production
API calls in production environments are to be authenticated using the
Authorization header with
Throughout this documentation, we will use Bearer Token
00112233-4455-6677-8899-aabbccddeeff. You should substitute this with your own token when making test calls.
Example of authenticated API call:
curl --request GET \ --url 'https://api.aviowiki.com/airports/search?query=Los%20Angeles' \ --header 'authorization: Bearer 00112233-4455-6677-8899-aabbccddeeff'
Your API key will be authorized to make calls to all our API endpoints, except for
/aircraft/searchHistory, which require an additional role to be added to your user.
Please get in touch to authorize your API key to access these endpoints.
Of course, our replies return appropriate response codes. If you receive a response code in the
5xx range, the response body will follow the Error data model.