跳到主要内容

开始

TOGAPhotos 公共 API 提供飞机信息、飞机历史记录和机场查询，面向个人、教育和非盈利用途免费开放。查询结果不保证实时更新。

基础地址​

https://api.togaphotos.com

认证和限速​

匿名使用​

不带凭据的请求可以直接访问公开接口，适合临时查询、个人脚本、教学示例和低频测试。所有匿名请求共享每分钟 60 次的额度。

curl "https://api.togaphotos.com/aircraft?reg=B-1086"

可以打开 Aircraft Demo，用默认注册号 B-1086 查询飞机；也可以打开 Airport Demo，用默认关键词 PEK 查询机场。

API 凭据​

如需更稳定的访问额度，可以申请 API 凭据，并在请求头中携带：

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

带有有效 X-API-ID 和 X-API-Secret 的请求会豁免匿名总限速。缺少凭据时按匿名请求处理；提交了无效凭据时返回 401。

缓存时效​

成功的查询结果会缓存 24 小时。响应中的 cached_at 表示当前结果的缓存时间，使用 UTC 时区。在缓存有效期内，重复查询可能返回相同的数据和时间。

可用接口​

  • GET /aircraft?reg=<registration>：按注册号关键词搜索飞机，reg 长度为 3 到 32 个字符。
  • GET /aircraft/{id}/records：查询指定飞机的历史记录。
  • GET /airport?search=<keyword>：按 IATA、ICAO 代码或中文、英文名称搜索机场。

查看 Aircraft API 和 Airport API 获取完整请求和响应示例。

使用声明​

调用前请阅读使用声明，了解允许的用途和访问限制。