@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Airport & City Search
@base https://test.api.amadeus.com/v1
@version 1.2.3
@endpoints 2
@toc reference-data(2)

@endpoint GET /reference-data/locations
@desc Returns a list of airports and cities matching a given keyword.
@required {subType: any # sub type of the location (AIRPORT and/or CITY), keyword: any # keyword that should represent the start of a word in a city or airport name or code.   Supported charaters are: A-Za-z0-9./:-'()"}
@optional {countryCode: any # Country code of the location using [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US)., 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: * analytics.travelers.score - sort by the number of travelers by airport or city, the airports and cities with the highest traffic are on top of the results, view: any # select the level of information of the reply: * LIGHT - Gives only the IATACode, name, detailedName, cityName and countryName * FULL - Adds on top of the LIGHT information the timeZoneOffset, geocode, detailed address and travelers.score default option is FULL}
@returns(200) Successful Operation
@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION  2781    | INVALID LENGTH 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING}

@endpoint GET /reference-data/locations/{locationId}
@desc Returns a specific airports or cities based on its id.
@required {locationId: any # identifier of the location}
@returns(200) Successful Operation
@errors {400: code    | title                                  ------- | -------------------------------------  572     | INVALID OPTION, 404: Not Found}

@end