义务教育控辍保学的进度记录与统计核对:HTTP 接口

围绕义务教育控辍保学的进度记录与统计核对,说明HTTP 接口与外部系统的配置前提与核对动作,结合辍学风险台账、劝返记录确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

本页面向义务教育控辍保学场景,材料来自辍学风险台账、劝返记录、家访记录三类台账与回执。台账按周或月更新,字段含学生标识、风险等级、劝返日期、家访日期、签字与回执编号。台账进入该功能时,作为请求体与路径参数的取值来源,由工作流里的 HTTP 节点向外发请求;劝返记录与家访记录分别承担进度明细与佐证角色,统计口径说明放在表头,供后续节点解析响应后汇总。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「进度表与统计口径说明」由后续节点解析响应,或外部系统按约定处理接着完成。路径参数、请求体与请求头三处都能用变量占位,变量来自全局变量、系统变量或前方节点输出。

对象判断核验动作
辍学风险台账名称、数量、日期与劝返记录对得上用一条样例请求比对返回,核对台账字段与接口约定是否一致
劝返记录劝返日期与签字、回执齐全在变量面板核对每个占位来源,确认日期与签字字段非空
家访记录家访日期与版本同台账一致在请求预览里看渲染后的完整地址,比对家访记录日期与版本
请求头鉴权信息按外部系统要求传入核对请求头名称与取值来源,确认 Authorization 取值来自 variables

容易做错的三处

  • 现象:同一学生在台账与劝返记录里的名称、数量、日期对不上。原因:两份材料各自维护,未按统一口径核对。
  • 现象:家访记录版本未同步,旧版仍被引用。原因:材料更新后未同步到请求取值来源。
  • 现象:劝返记录缺签字或回执,统计仍计入合计。原因:例外未在表头口径中写清,核对时未剔除。

怎么确认配好了

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

业务测试:用一周记录核对合计,看口径与例外是否写清。

  • 在变量面板核对每个占位的来源,确认 variables 与 Authorization 可追溯到具体出处。
  • 用一条样例请求比对返回,检查请求体字段与外部接口约定一致。