接口联调验收要点

背景

接口联调验收用于确认任务、媒体、遥测、AI结果、图斑和状态能在系统之间稳定流转。重点是可追溯、可重试、可定位问题。

验收维度

• 字段完整性：必填字段、类型、单位、坐标系、时间格式。
• 调用链路：请求、响应、错误码、日志、重试。
• 数据一致性：跨系统ID、状态、数量、时间是否一致。
• 异常处理：超时、失败、重复推送、权限过期。
• 可观测性：日志、接口记录、任务状态、人工补偿入口。

项目落地关注点

• 先用固定样例联调，再接真实任务数据。
• 每个接口要保留成功样例和失败样例。
• 重复推送要有幂等策略，避免生成重复问题。

数据/接口要点

• 联调样例应包含任务、媒体、遥测、AI结果、图斑、复核状态。
• 每个接口要明确调用方、接收方、认证方式、失败重试方式。
• 对外字段要明确坐标系、时间格式、枚举值和单位。

验收/风险

• 检查下游能否打开上游传来的证据地址。
• 检查失败后是否能重试或人工补发。
• 检查字段缺失时是否有明确错误提示。

待补充

• 补充接口联调用例表。
• 补充实际接口错误码。