OpenSky REST API：飞机状态向量查询

OpenSky 官方 REST 文档提供 /api/states/all，可匿名读取最新飞机状态向量，按 ICAO24 或经纬度框过滤；匿名10秒分辨率、每日400 credits。认证仅用 OAuth2，可查近1小时；价格和数据许可未知，未调用。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：航空公共数据／OpenSky 最新飞机状态向量 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · d08e3d6e8ab2d4575c350265ad0f7a6a97f0e2ecf3bb81bc9fc74349c3155050

本卡聚焦状态向量 GET 接口，返回按固定下标排列的航空器状态数据。匿名访问仅取最新状态，time 参数被忽略；认证、航班与实验轨迹接口另有规则。本次未查询实际航空器、创建 API 客户端或执行认证代码。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-8aafd58fad94121beaea6475 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-8aafd58fad94121beaea6475
名片版本: 2
资料更新: 2026-10-24T18:15:04.1635966+00:00
原作者 / 提供者: The OpenSky Network
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

可选 icao24 为一或多个十六进制应答机地址，多地址可重复该参数。
区域过滤需同时提供 lamin、lomin、lamax、lomax，采用 WGS84 十进制度。
可选 extended=1 请求 aircraft category；time 只对允许的认证历史范围生效。

输出

JSON 对象含 time 和 states；states 是二维数组，每行一条固定下标状态向量。
行索引含0=icao24、1=callsign、5=longitude、6=latitude、7=baro_altitude、8=on_ground、9=velocity、10=true_track 等，部分值可为 null。
坐标为 WGS84，baro_altitude 单位米、velocity 单位m/s；不能把向量当有字段名的对象解析。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：无。本页明确匿名 /states/all 示例及按IP分桶限制，适用于最新状态读取。认证访问仅支持 OAuth2 client_credentials，Basic 用户名密码不再接受；匿名能力不能推广到 /states/own 等需要认证的端点。

运行前提

匿名查询仅最新状态，10秒时间分辨率，time 会被忽略。
若需认证近1小时状态，要有 OpenSky 账号/API client，以 client_credentials 换 Bearer 凭据；文档称30分钟过期。
必须遵守 credits 配额和429等待说明；本次不注册、取凭据、请求数据或运行示例。

公开请求示例

{
  "method": "GET",
  "notes": "\u5B98\u65B9\u745E\u58EB\u8303\u56F4 bbox \u793A\u4F8B\uFF0C\u533F\u540D\u6700\u65B0\u6570\u636E\u8DEF\u5F84\uFF1B\u672A\u8C03\u7528\u3002",
  "query": {
    "lamax": 47.8229,
    "lamin": 45.8389,
    "lomax": 10.5226,
    "lomin": 5.9962
  },
  "url": "https://opensky-network.org/api/states/all"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。正文给 credit 配额和每次 credit 消耗，但未明确金额价格、商业许可或免费使用条款，不把 credits 当货币报价。

价格来源 · 未知

资料去向

提供者服务器。匿名限额按IP分桶，认证与查询由 OpenSky 服务端处理。所捕获页未说明请求日志/数据保留，本次未发送坐标查询或凭据。

限制

匿名只取最新状态且10秒分辨率；认证近1小时、5秒分辨率，过旧 time 返回400。
states/tracks/flights 各有独立 credit bucket；匿名每类每日400，标准用户每日4000，其他等级另有额度。
/states/all 费用随 bbox/全局查询变化为1–4 credits，不能把每日400 credits 直接等同400次全球请求。
额度耗尽返回429及 X-Rate-Limit-Retry-After-Seconds；/states/own 需认证，免 credits 不表示所有状态接口不限额。
本页其它轨迹/航班端点有不同时间范围及实验说明，本卡不套用为状态接口契约。

仍需核对

金额费用、使用/再分发许可、SLA、日志保留及实际覆盖准确性未知。
真实账户等级、当日额度、OAuth 客户端权限和实时可用性未验证。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:14:14.5773428+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

OpenSky REST API — The OpenSky Network API 1.4.0 documentation · 官方文档 · 2026-10-25T02:14:14.5773428+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://openskynetwork.github.io/opensky-api/rest.html",
  "final_url": "https://openskynetwork.github.io/opensky-api/rest.html",
  "status_code": 200,
  "title": "OpenSky REST API \u2014 The OpenSky Network API 1.4.0 documentation",
  "description": null,
  "checked_at": "2026-10-24T18:14:14.5773428\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-8aafd58fad94121beaea6475",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://openskynetwork.github.io/opensky-api/rest.html"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。