✈️ WOA 助手 · 后端 API

服务运行中。

飞友资料 /api/players

方法路径说明
GET/api/players广场列表，支持 ?keyword=&class=&airport=&pax=&page=&size=
GET/api/players/{id}详情（包含私有 contact）
POST/api/players创建飞友
PUT/api/players/{id}更新
DELETE/api/players/{id}删除

匹配引擎 /api/match

POST/api/match查找「能接我所需机型」的玩家
POST /api/match
{
  "wantPlaneClasses": ["D","E"],
  "wantPaxOrCargo": "pax",         // pax | cargo | both
  "wantDestinations": ["LHR"],      // 可选
  "page": 1,
  "size": 20
}

申请记录 /api/applications

POST/api/applications发飞机 / 接飞机 申请（含通知）
GET/api/applications列表（按方向筛选 ?direction=out|in）
POST /api/applications
{
  "toPlayerId": "abc123",
  "toName": "玩家甲",
  "direction": "send" | "apply",
  "text": "你好 ..."  ,
  "channel": "email" | "sms" | "none",
  "toContact": "a**@gmail.com"  // 可选脱敏值
}

通知 /api/notifications/dispatch

POST/api/notifications/dispatch直接发通知（独立通道）

健康/统计 /api/stats

GET/api/stats玩家数 / 申请数 / 通知数