区县教研活动与听评课的授权访问与对外服务:HTTP 接口

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

这个品类的数据长什么样

区县教研活动与听评课材料,含教研活动通知、听课记录、评课纪要。通知来自教研部门,听课记录由听课人员填写,评课纪要由评课组整理。更新节奏为活动前发通知、活动中记听课、活动后出纪要。字段有活动名称、日期、授课人、听课人、评课意见、签字或回执。材料进入授权访问与对外服务功能时,通知决定可见范围,听课记录与评课纪要决定字段与签字是否齐全。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。可对外的入口与授权范围由后续节点解析响应,或外部系统按约定处理接着完成。

对象判断核验动作
教研活动通知通知里的活动名称、日期与授权范围要和听课记录、评课纪要一致在请求预览里看渲染后的完整地址,核对通知字段与返回字段
听课记录听课人、授课人、日期与签字或回执要和评课纪要对应核对请求头名称与取值来源,用样例请求比对返回
评课纪要评课意见、签字与版本要和通知、听课记录同步在变量面板核对每个占位的来源,检查 variables 是否解析
对外服务入口访问者身份与可见范围匹配,越权不可见用受限身份访问一次,看 Authorization 与 responseData 是否符合设定

容易做错的三处

  • 现象:同一记录在两份材料里的名称、数量、日期对不上。原因:通知与听课记录各自维护,未按同一字段口径核对。
  • 现象:评课纪要版本未同步,旧版仍被对外服务读取。原因:HTTP 节点请求地址或路径参数占位变量未更新到最新来源。
  • 现象:听课记录缺签字或回执,对外服务仍返回可见。原因:鉴权信息与可见范围未按外部系统要求传入。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 Authorization、variables、responseData 三处占位可追。

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

  • 核对请求头名称与取值来源,确认鉴权信息按外部系统要求传入
  • 在变量面板核对每个占位的来源,用一条样例请求比对返回字段