HTTP API
启用 HTTP API:在 fsd.conf 中设置 [httpapi] 段。
ini
[httpapi]
enabled=true
port=8080
key=your-secret-key1
2
3
4
2
3
4
鉴权
除 CORS 预检(OPTIONS)外,所有请求需携带密钥:
http
Authorization: Bearer <key>1
密钥不匹配返回 403 Forbidden。
端点
GET /api/status
返回服务器状态(JSON)。别名:/api/v1/status。
bash
curl -H "Authorization: Bearer <key>" http://127.0.0.1:8080/api/status1
/api/flightplan
飞行计划的读写,别名 /api/v1/flightplan。
| 方法 | 参数 | 说明 |
|---|---|---|
GET | ?callsign=<呼号> | 查询指定呼号的飞行计划 |
POST | 请求体 | 提交 / 更新飞行计划 |
DELETE | ?callsign=<呼号> | 删除飞行计划 |
bash
# 查询
curl -H "Authorization: Bearer <key>" "http://127.0.0.1:8080/api/flightplan?callsign=CCA123"
# 删除
curl -X DELETE -H "Authorization: Bearer <key>" "http://127.0.0.1:8080/api/flightplan?callsign=CCA123"1
2
3
4
5
2
3
4
5
状态码
| 码 | 含义 |
|---|---|
200 | 成功 |
201 | 已创建 |
400 | 请求错误(如缺少 callsign) |
403 | 密钥无效 |
404 | 未找到 |
405 | 方法不允许 |
500 | 服务器内部错误 |
反向代理
建议用 Nginx 反代 8080 并启用 HTTPS,同时用 nginx_fsd_security.conf 屏蔽对 fsd.conf、cert.txt 的直接访问。