整理人:车载终端 APP 开发(前端/移动侧) · 整理日期:2026-08-31 · 对应文档版本:对接文档 v1.0 · APP 当前版本:v1.1.3(含定位上报 + 实时 WS 接单)
POST /auth/login 与 GET /auth/me 行为符合文档;联调账号 京A12001 / 123456(绑定 vehicle_id=1)可用,返回字段 vehicle_id / vehicle_name / vehicle_plate / work_id / role 与前端预期一致。
GET /crews、GET|POST /vehicles/:id/duty、POST /vehicles/:id/duty/sign-out 字段与约束(司机、医生各必选 1 人;新签到自动签出旧组)均符合文档,已联调通过。
状态枚举 SENT→ACKED→DEPARTED→ON_SCENE→TRANSPORTING→ARRIVED_HOSPITAL→COMPLETED 与“每步仅向后推进一格”约束一致;POST /orders/:id/status 返回最新对象与时间戳字段齐全。前端状态机已按此实现并验证。
文档第五节~七节给出的请求体字段(/emr 三字段、/telemetry/report BD-09 坐标、/cti/events CALL_OUT)字段名逐字一致,前端已按此构造请求。
POST /telemetry/report 明确要求 lng/lat 为 BD-09。APP 若把 hospitals 坐标按 BD-09 打点,而实际是 WGS84/GCJ-02,地图会偏移数百米~公里。
影响“送往医院”地图展示与院内导航偏差,影响派送准确性。
需后端确认/hospitals 返回的 lng/lat 究竟是 WGS84 / GCJ-02 / BD-09 哪一种?是否与 telemetry 上报同一坐标系?
wss://…:9952/ws/vehicle?token=<crew_token>(非通用 /ws);握手首帧 CONNECTED 带 vehicle_id;推送事件类型仅本车:DISPATCH_ORDER(订单分配)/ ORDER_UPDATE(订单更新)。前端已按此实现:路径修正、CONNECTED 设连接态、两事件转发并触发首页/任务页刷新,DISPATCH_ORDER 额外 toast「收到新出车指令」并跳任务页。
仍待定推送 message 的 JSON 结构(字段名与取值)文档未给:如 DISPATCH_ORDER 是带完整 order 对象还是仅 order_id?ORDER_UPDATE 改派/中心改状态时字段如何?前端现 best-effort 用 activeOrders 重新拉取刷新,待后端定结构后可改为直接用推送 payload 局部更新。
需后端确认① 推送 message 的完整 JSON 示例(含字段)?② 推送时机(新下发/改派/中心修改状态时是否也推)?③ 心跳 PING/PONG 是否由前端处理(文档称已具备,前端暂未自研心跳)。
POST /emr,无对应的 GET /emr?order_id=。APP 进入病历页时,已保存内容无法从服务端回填(现靠 incident 只读 + 本地缓存),换设备/重装后丢失。
需后端确认是否提供病历读取接口?若无,APP 是否允许“再次保存覆盖”?字段是否完全一致?
force:true 踢旧会话。车载端频繁断网重连/多端登录易反复触发 409,每次都让用户手点“强制登录”体验差。
需后端确认是否支持“同 vehicle 刷新 token 不冲突”或“设备指纹白名单”?还是统一由前端在重连时自动 force?该决策影响前端登录策略。
GET /auth/me 未返回该字段,APP 暂置灰禁用该按钮。
建议在 auth/me 增加 desk_phone(调度台直拨号),或新增 GET /station/contact 返回站点联系方式;APP 读取后启用「呼叫本调度台」。
默认未配置前,「呼叫 120 急救调度中心」按钮始终可用(120 为全国通用急救号),专线按钮禁用并提示“待后台配置”。
文档建议以 WS 推送替代轮询。若确认要做,请后端补齐“仅本车”订单事件(见 I-CONF-2)。
/emr 仅有 complaint / diagnosis / treatment 三文本字段,体温/脉搏/呼吸/血压需拼接进 complaint 字符串上报。
待实现是否计划增加 temperature / pulse / respiration / blood_pressure 结构化列?改造前前端复用拼接逻辑;改造后需同步接口版本。
tel:120 直拨(最简单、走系统电话,但无通话记录回传服务端);B) POST /cti/events CALL_OUT(走合作方 CTI,可留痕,但需通信公司对接)。
结论用户已定:呼叫中心标签页走系统 tel: 直拨(含 120 与调度台专线),不依赖 CTI。需真机验证 WebView 能拉起拨号;若不行再评估是否改 CTI。
status 枚举为 STANDBY / DISPATCHED / ON_WAY;前端映射已与之对齐:待命(SENT/COMPLETED)→ STANDBY,接单未出发(ACKED/DEPARTED)→ DISPATCHED,出发后(ON_SCENE/TRANSPORTING/ARRIVED_HOSPITAL)→ ON_WAY。与调度中心对帐口径一致,建议关闭。
说明属前端可定规则,文档已给出枚举,按上述映射实现并通过校验。