区县教研活动与听评课的问答受理与缺项补问:HTTP 接口

围绕区县教研活动与听评课的问答受理与缺项补问,说明HTTP 接口与外部系统的配置前提与核对动作,结合教研活动通知、听课记录确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

本页面向区县教研活动与听评课场景,材料来源包括教研活动通知、听课记录、评课纪要,更新节奏随活动批次与学期安排滚动。这些材料进入问答受理与缺项补问功能时角色不同:通知提供活动主题、时间、地点与参与范围;听课记录承载课堂观察的环节、时长与观察点;评课纪要记录评议意见、结论与签字回执。字段特征集中在三类:日期(活动日、听课日、评议日)、签字(主持人、记录人、评议人)、数量(节次、听课人数、评议条数)。同一记录在两份材料里的名称、数量、日期对不上时,受理环节需要先识别缺项,再向提交方追问,补齐后才能形成受理记录与问项清单,转承办人处理。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。受理记录与补齐的问项由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体中的占位变量来自全局变量、系统变量或前方节点输出,可在请求预览里核对渲染结果。

对象判断核验动作
教研活动通知日期、签字与数量字段是否与听课记录、评课纪要一致在请求预览里核对渲染后的完整地址,比对通知日期与听课日、评议日;检查主持人签字与回执是否齐全;用一条样例请求比对返回字段
听课记录名称、节次数量与评课纪要是否对得上核对请求体字段与外部接口约定是否一致,检查听课节次、观察点名称在两份材料中的写法;在变量面板核对每个占位来源,确认 variables 取值来自前方节点输出
评课纪要版本是否同步、签字与回执是否缺项核对请求头名称与取值来源,确认 Authorization 按外部系统要求传入;比对纪要版本号与通知版本;缺签字或回执时先追问再作答
受理记录与补齐的问项缺项是否被识别并追问、回答是否有材料依据用一条样例请求比对返回,确认 responseData 中缺项字段与追问项对应;对一条样例比对结果,检查问项是否引用通知、听课记录或评课纪要原文

容易做错的三处

  • 现象:同一记录在通知与听课记录里的名称、数量、日期对不上。原因:两份材料分别录入,未做字段级比对,受理时直接放行。
  • 现象:评课纪要版本未同步,旧版签字与回执被当作有效材料。原因:材料更新后未回写受理记录,追问环节仍按旧版字段判断。
  • 现象:请求返回 401 或外部系统收到空字段。原因:Authorization 取值来源未核对,或 variables 占位未解析成实际值。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果;检查 responseData 中缺项与追问项是否对应,variables 占位是否追到具体出处。

业务测试:提一个缺关键信息的问句,看是否先追问再作答;补齐后再核对受理记录与问项清单是否转承办人处理。

  • 在请求预览里核对渲染后的完整地址、请求头名称与取值来源,确认 Authorization 与 variables 占位解析成实际值。
  • 用一条样例请求比对返回,核对请求体字段与外部接口约定一致,检查 responseData 中缺项字段与追问项是否对应。