中小学心理健康筛查与转介的资料版本与变更维护:HTTP 接口

围绕中小学心理健康筛查与转介的资料版本与变更维护,说明HTTP 接口与外部系统的配置前提与核对动作,结合心理筛查方案、访谈记录确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

中小学心理健康筛查与转介场景里,常备三类材料:心理筛查方案、访谈记录、转介单。方案含筛查维度、评分口径与责任分工;访谈记录含访谈日期、对象、要点与访谈人签字;转介单含转介原因、接收方、回执与双方签字。材料来自校内心理教师、班主任与外部机构,更新节奏随学期、复测与个案变化而变。进入本功能时,方案与记录作为请求体字段来源,转介单作为外部系统回传字段的对照依据,三者共同支撑版本台账与变更记录。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「版本台账与变更记录」由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体均可通过 variables 引用全局变量、系统变量或前方节点输出。

对象判断核验动作
心理筛查方案方案版本号与生效日期须唯一且可追在请求体比对方案名称、版本号与日期,核对 variables 来源
访谈记录访谈日期、对象与签字须与方案口径一致用一条样例请求比对返回字段,检查签字与回执是否齐全
转介单转介原因、接收方与回执须与台账同步核对请求头 Authorization 与返回字段,确认引用同步
HTTP 请求路径参数、请求体与请求头占位能解析成实际值在请求预览看渲染后的完整地址与 responseData 字段

容易做错的三处

  • 现象:同一访谈记录在方案与转介单里的日期对不上。原因:请求体字段取自不同节点输出,未统一到同一版本号。
  • 现象:旧版方案仍在被引用,新版未同步。原因:变更后未更新知识库或对外文档,引用未随版本号刷新。
  • 现象:转介单缺签字或回执。原因:外部系统按约定处理时未回传签字字段,后续节点未校验返回字段。

怎么确认配好了

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

业务测试:改一处内容,看版本号与引用是否同步更新。

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