增强扫描接口调用规范.docxVIP

增强扫描接口调用规范

增强扫描接口调用规范

一、（1）标准化数据封装机制的深度落地。在增强扫描接口的调用流程中，标准化数据封装是确保请求能够被服务端准确解析的前提条件。不同于普通业务接口仅需传递基础参数，增强扫描接口涉及影像数据流、扫描策略配置、质控阈值设定等多维度信息，若缺乏统一的封装规则，极易出现字段歧义、格式冲突等问题。具体实施中，需严格定义请求体的JSONSchema结构，其中“scan_config”节点需包含扫描层厚、重建算法、造影剂注射速率等12项必填参数，每个参数的数据类型、取值范围、枚举规则均需明确标注——例如扫描层厚的取值需在0.5mm至5mm之间，且仅允许保留一位小数；“image_data”节点需采用Base64编码传输原始DICOM影像流，同时在“meta_info”子节点中附加影像的采集设备型号、拍摄时间戳、患者体位等辅助信息，避免因元数据缺失导致扫描参数匹配失效。响应数据的封装同样需要细化，除常规的“code”“message”字段外，“result_data”节点需分层级返回预处理后的影像特征点集、病灶概率矩阵、三维重建坐标映射表三类核心数据，每类数据均需附带校验哈希值，确保客户端在接收过程中可验证数据完整性。针对批量扫描场景，还需设计分页封装机制，单批次请求最多允许携带20组扫描任务，每组任务的执行状态需通过的“task_id”进行标识，避免多