API 服务

智创AI 提供公开 RESTful API。机场气象等公开接口无需登录即可调用；需登录的接口请在请求头携带 Authorization: Bearer <token>。已开启 CORS，翼图 APK 及第三方应用可跨域调用。

机场气象 METAR / TAF

输入 ICAO 四字码（如 ZBAA 北京、ZSPD 上海），或从下方按城市/名称搜索机场。

结果将显示在此

已开放接口清单

方法路径说明
GET/api/weather/:icao机场气象(结构化)
GET/api/airports?q=机场检索
GET/api/update/check版本更新检测
GET/api/data/latest最新数据更新
GET/api/kb/search?q=知识库检索
POST/api/ai/askAI 专业问答
POST/api/auth/send-verify-code发送邮箱验证码（注册/绑定，免费）
POST/api/auth/register注册（需邮箱 + 邮箱验证码实名）
POST/api/auth/login登录
POST/api/auth/bind-email已登录用户绑定邮箱（需验证码）
GET/api/v1/wx/radar/minifest2.json雷达帧清单（时间轴/缩放上限）
GET/api/v1/wx/radar/{Y}/{M}/{D}/{HHMM}/{z}/{x}/{y}/reflectivity.webp雷达回波瓦片（降水强度）
GET/api/v1/wx/meta/forecast/{model}/minifest.json航空风场清单（起报时间/步长）
GET/api/v1/wx/forecast/{model}/{ref}/{valid}/{z}/{x}/{y}/wind-{level}.jpg航空风场瓦片（UV 编码，按高度层）

气象接口返回结构字段：icao / airport / metar{ wind, visibility, weather, clouds, temperature_c, dewpoint_c, altimeter, flight_category, decoded, raw } / taf{ raw, periods }，供 APK 直接解析渲染。

雷达拼图 API

全国雷达回波拼图，分钟级更新，支持历史帧回放与临近预报帧。App 端以「帧清单 → 瓦片」两步拉取， 时间轴直接由清单驱动，无需本地推算时间。

参数说明
minifest2.json帧清单：返回帧时间轴与数据缩放上限（当前 7）
{Y}/{M}/{D}/{HHMM}帧时刻（UTC），来自清单时间轴，5 分钟一帧
{z}/{x}/{y}标准 XYZ 瓦片坐标；建议 z≤7，更高级别由客户端过缩放
reflectivity.webp回波强度瓦片（webp，含多通道强度信息）

示例：GET /api/v1/wx/radar/minifest2.json?noCacheFragment=1030
GET /api/v1/wx/radar/2026/10/27/1030/5/25/12/reflectivity.webp?multichannel=true&maxt=20261027103000

缓存：瓦片按内容寻址长期缓存（同 URL 不重复回源），清单 60 秒。App 端应带 10 分钟内存缓存 + 磁盘缓存命中优先。

航空风场 API

高空与近地面风场（ECMWF-HRES），按气压高度层取用，供风场色斑/风羽渲染与航线风分量参考。

参数说明
minifest.json返回起报时间 ref、可用预报步长 dst、可用高度层
{ref}/{valid}起报时刻 / 有效时刻（YYYYMMDDHH，UTC）
wind-{level}.jpg风场瓦片，257×265 网格；R 通道=U 分量，G 通道=V 分量，黑色=无数据
level高度层：surface / 100m / 850h / 700h / 500h / 300h / 250h / 200h

示例：GET /api/v1/wx/meta/forecast/ecmwf-hres/minifest.json
GET /api/v1/wx/forecast/ecmwf-hres/2026102612/2026102615/3/6/3/wind-850h.jpg

缓存：起报时间 + 有效时间定址，单次起报后瓦片不可变 → 长期缓存；跨用户共享，勿在 URL 追加随机数。

气象图层接入说明（App 后台）

两类数据均为标准 XYZ 瓦片，App 侧可直接绑定地图渲染层：雷达为可直接叠加的位图瓦片； 风场为 UV 编码位图，需在客户端解码为速度色阶或风羽后渲染。

可用性策略（建议实现）：客户端优先直连数据源，单次请求超过 3 秒或失败即切换到本服务中转通道， 并在本进程内保持；下次冷启动重新探测。切换过程对用户不可见，不弹提示。

频率建议：雷达帧动画预取不超过 8 帧；风场瓦片随地图移动按视口加载，缩放 z≤6。服务端已做回源去重与并发锁，正常使用不会触发限流。

AI 专业问答（预留）

登录后调用 POST /api/ai/ask 并传入 { "question": "如何判读 TAF 中的 TEMPO？" }， 系统将基于知识库检索相关文章并由大模型作答（需在服务端配置 LLM 密钥）。未配置时返回知识库检索结果。