实验室危化品采购与台账的授权访问与对外服务:HTTP 接口

围绕实验室危化品采购与台账的授权访问与对外服务,说明HTTP 接口与外部系统的配置前提与核对动作,结合危化品采购申请、领用登记确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

实验室危化品采购与台账涉及采购申请、领用登记、库存台账三类材料。采购申请记录品名、规格、数量、申请日期与审批签字;领用登记记录领用人、领用数量、领用日期与保管员签字;库存台账记录结存数量、批次、更新日期与核对签字。三类材料进入授权访问与对外服务功能时,采购申请作为入口依据,领用登记作为过程凭证,库存台账作为结存结果,共同决定访问者可见范围。材料更新节奏随采购批次与领用频次变化,字段特征以名称、数量、日期、签字为核心,同一记录在不同材料间须保持一致,版本须同步,签字与回执须齐全。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。可对外的入口与授权范围由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、请求头与请求体三处均可用变量占位,变量来自全局变量、系统变量或前方节点输出。

对象判断核验动作
采购申请名称、数量、日期与签字须与领用登记、库存台账一致在请求预览里核对渲染后的完整地址,比对三份材料的名称、数量、日期与签字
领用登记领用数量、领用日期与保管员签字须与库存台账同步核对请求头名称与取值来源,检查 Authorization 与 variables 是否按外部系统要求传入
库存台账结存数量、批次与更新日期须与采购申请、领用登记对得上用一条样例请求比对返回,检查 responseData 字段与台账约定是否一致
请求体字段与外部接口的约定一致用一条样例请求比对返回,核对字段名称与取值来源

容易做错的三处

  • 现象:同一记录在两份材料里的名称、数量、日期对不上。原因:采购申请与领用登记分别录入,未按同一批次核对。
  • 现象:版本未同步,库存台账仍显示旧结存。原因:领用登记更新后未触发台账同步,请求体字段取到旧值。
  • 现象:缺签字或回执,授权范围无法确认。原因:审批签字或保管员签字缺失,外部系统收到空字段。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 responseData 字段与约定一致。

业务测试:用受限身份访问一次,看可见范围是否符合设定。

  • 在变量面板核对每个占位的来源,确认 variables 可追到全局变量、系统变量或前方节点输出。
  • 核对请求头名称与取值来源,确认 Authorization 按外部系统要求传入。