关于Amadeus API按国家获取机场列表的技术咨询

嘿，很高兴你开始接触Amadeus自助服务！针对你问的按国家获取机场列表的需求，Amadeus确实有对应的API可以轻松实现，我给你梳理一下具体步骤：

核心API选择 #

你需要用到Reference Data - Locations API，这个端点专门用来查询各类旅行地点（包括机场、城市、火车站等），支持按国家进行精准筛选。

具体调用步骤 #

1. 获取访问令牌
   首先得通过Client Credentials Flow获取访问令牌，这是调用Amadeus API的必备认证步骤。你可以在Amadeus开发者控制台里用你的API密钥（Client ID）和密钥密码（Client Secret）生成，示例请求如下：

   curl "https://test.api.amadeus.com/v1/security/oauth2/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
   

   拿到返回的access_token后，就可以用来调用后续的地点查询接口了。

2. 按国家查询机场列表
   调用GET /v1/reference-data/locations端点，通过以下关键参数筛选结果：

   • subType=AIRPORT：指定只返回机场类型的地点，排除城市、火车站等其他类型
   • countryCode：传入目标国家的ISO 3166-1 alpha-2两位代码，比如中国用CN，美国用US，日本用JP
   • 可选参数：page[limit]可以控制每页返回的结果数量（默认10，最大100），避免一次返回过多数据

   示例curl请求：

   curl "https://test.api.amadeus.com/v1/reference-data/locations?subType=AIRPORT&countryCode=CN&page[limit]=20" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
   

3. 解析返回结果
   接口会返回符合条件的机场列表，每个条目包含机场的IATA代码（比如PEK）、名称、地理位置坐标、所在城市等核心信息，完全能满足你获取机场列表的需求。

注意事项 #

• 确认你的API套餐包含这个端点的调用权限，Amadeus自助服务的免费套餐一般都覆盖这个接口的基础调用额度
• 国家代码一定要用正确的两位字母格式，否则会返回空结果或者参数错误
• 如果需要更详细的机场信息（比如航站楼、时区、设施），可以用返回结果里的id，调用GET /v1/reference-data/locations/{id}端点查询详情

如果调用过程中遇到认证失败、参数错误或者其他问题，随时来补充细节，我再帮你排查！

内容的提问来源于stack exchange，提问作者Ifeanyi Jorn Kalu