@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Airport Nearest Relevant
@base https://test.api.amadeus.com/v1
@version 1.1.2
@endpoints 1
@toc reference-data(1)

@endpoint GET /reference-data/locations/airports
@desc Returns a list of relevant airports near to a given point.
@required {latitude: any # latitude location to be at the center of the search circle, longitude: any # longitude location to be at the center of the search circle}
@optional {radius: any # radius of the search in Kilometer. Can be from 0 to 500, default value is 500 Km., page[limit]: any # maximum items in one page, page[offset]: any # start index of the requested page, sort: any # defines on which attribute the sorting will be done from the best option to the worst one: * **relevance** - Score value calculated based on distance and traffic analytics * **distance** - Distance from the location to the geo-code given in API request parameters * **analytics.flights.score** - Approximate score for ranking purposes calculated based on estimated number of flights from/to airport in one reference year (last year) * **analytics.travelers.score** - Approximate score for ranking purposes calculated based on estimated number of travelers in the airport for one reference year (last year)}
@returns(200) Successful Operation
@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING}

@end