Airport API

Airport API 支持按 IATA 代码、ICAO 代码、中文名称或英文名称搜索机场，返回机场名称和代码。查询结果不保证实时更新。

可以在 Airport Demo 中使用默认关键词 PEK 试一次查询。

请求头

匿名请求无需额外请求头。所有公开接口的匿名请求共享每分钟 60 次的额度。

携带有效的 API 凭据可豁免匿名总限速，申请方式见获取 API 凭据。

X-API-ID: <id>
X-API-Secret: <secret>

搜索机场

GET https://api.togaphotos.com/airport?search=PEK

请求参数

参数	位置	类型	必填	说明
`search`	查询参数	string	是	IATA 代码、ICAO 代码、中文或英文名称关键词，例如 `PEK`、`ZBAA` 或 `北京`。去除首尾空白后不能为空，最长为 255 个 UTF-16 代码单元（常用汉字和英文字母各占一个），不接受控制字符或无效 UTF-8 编码。

只允许一个 search 参数，不接受重复参数或其他查询参数。

请求示例

curl "https://api.togaphotos.com/airport?search=PEK"
curl --get --data-urlencode "search=北京" "https://api.togaphotos.com/airport"

响应示例

以下为示例响应，cached_at 为示例时间。

{
  "msg": "查询成功",
  "data": [
    {
      "id": 1,
      "airport_cn": "北京首都国际机场",
      "airport_en": "Beijing Capital International Airport",
      "iata_code": "PEK",
      "icao_code": "ZBAA"
    }
  ],
  "cached_at": "2026-09-10T17:30:00Z"
}

响应字段

字段	类型	含义
`msg`	string	请求结果说明。
`data`	array	匹配关键词的机场列表，无匹配结果时为空数组。
`cached_at`	string	当前结果的缓存时间，使用 UTC 时区，格式为 ISO 8601。

`data[]` 字段

字段	类型	含义
`id`	number	机场标识。
`airport_cn`	string \| null	机场中文名称。
`airport_en`	string \| null	机场英文名称。
`iata_code`	string \| null	IATA 机场代码。
`icao_code`	string \| null	ICAO 机场代码。

缓存

成功的查询结果会缓存 24 小时。在缓存有效期内，重复查询可能返回相同的数据和 cached_at。

错误

400：缺少 search、关键词去除首尾空白后为空或超过长度限制、含控制字符或无效 UTF-8 编码、重复提交 search，或包含其他查询参数。
401：提交了无效 API 凭据。
429：匿名请求的共享额度已用尽，请稍后重试。
502：服务暂时无法提供有效响应，请稍后重试。

失败响应不会缓存。

请求头​

搜索机场​

请求参数​

请求示例​

响应示例​

响应字段​

data[] 字段​

缓存​

错误​

请求头