网状网络
ResQ 以去中心化网状网络运行,而非中心-辐射式云架构。无人机、地面单元 和操作员工作站组成对等网络;即使上游基础设施宕机或不可达,系统仍能继续 运行。- 节点通过本地优先传输(网状电台、LTE、Wi-Fi)通信,在条件允许时机会性 地与云端协调。
- Coordination API 设计为即使其上游依赖降级也能继续接受遥测并提供实时 状态。
- 没有单点故障。如果一个协调器掉线,对等节点继续共享遥测并排队工作。
503 Service Unavailable 出现 ——
重试指南见错误。
证据与链
任务中每个有后果的动作都会产生证据:- 无人机捕获传感器帧、视频和结构化遥测。
- 证据文件被锚定到 IPFS,通过其 CID(内容寻址标识符)引用。
- CID 锚定到 Solana,生成抗篡改的链。
- Infrastructure API 暴露两端:
/evidence用于 IPFS 负载,/blockchain/*用于链上锚点。
人在回路任务
ResQ 的自主流程都受 HITL 控制。平台实现 欧盟 AI 法案第 14 条 的人工监督:授权操作员必须先批准高风险动作,系统才会执行。 任务审批通过 Coordination API 暴露:GET /admin/missions/pending— 待审批的动作POST /admin/missions/approve— 批准一个待审任务POST /admin/missions/reject— 拒绝并记录原因
missions.approve 权限范围。缺少此权限的调用返回
403 —— 详见错误。
空域与许可
对于配送和自主飞行,ResQ 在 Solana 上使用链上的空域注册表。 Infrastructure API 的/solana 端点记录许可、配送事件和注册表查询。
调度器拒绝超出允许空域的飞行计划;此关卡位于任务审批之前,而非之后。
遥测与实时事件
两条流承载实时数据:- 摄取:无人机机队向 Coordination API 的
POST /fleet/telemetry推送遥测批次。批次在边缘缓存并重试 —— 遥测永远不会无声丢弃。 - 订阅:客户端通过
/events上的 Server-Sent Events 和/metrics上的 Prometheus 抓取消费实时状态(Coordination API)。
操作员身份与权限范围
操作员在POST /login 用用户名和密码进行身份验证,获得短时效 JWT
(参见认证)。Token 携带操作员的权限范围 ——
细粒度的权限,例如 missions.approve、evidence.write 或
airspace.admin。
通过身份验证但缺少所需权限范围的请求返回 403。向操作员展示该错误,不要
重试;需要管理员介入。
故障注入与仿真
Coordination API 暴露Simulation 端点用于故障注入,SDK 也提供仿真
框架。意图是在生产中依赖网状降级行为之前,先在测试中演练。在集成测试中
使用,而不是在实际操作中。
如何对应
下一步
快速开始
第一次认证调用。
认证
JWT 生命周期与权限范围。
API 参考
所有端点。