中小学课程表与课后服务排课的授权访问与对外服务:HTTP 接

围绕中小学课程表与课后服务排课的授权访问与对外服务,说明HTTP 接口与外部系统的配置前提与核对动作,结合总课表、教师任课表确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

中小学课程表与课后服务排课涉及三类材料:总课表、教师任课表、课后服务项目表。总课表来自教务处学期排课结果,按周次与节次更新;教师任课表来自教研组汇总,按教师姓名与学科标注;课后服务项目表来自德育处与校外机构确认单,按项目名称、参与人数与日期登记。三类材料进入授权访问与对外服务功能时,总课表作为主数据决定班级可见范围,教师任课表作为身份映射决定教师可见范围,课后服务项目表作为扩展数据决定家长与上级可见条目。字段特征集中在名称、数量、日期、签字与回执,更新节奏为学期初集中发布、学期中按变更单滚动修订。对外入口按访问者身份返回对应材料片段,越权条目不可见。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「可对外的入口与授权范围」由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体均可通过 variables 占位,鉴权信息按外部系统要求放入 Authorization,返回内容在 responseData 中读取。

对象判断核验动作
总课表班级、周次、节次与任课教师名称在两份材料中一致,签字与回执齐全核对总课表与教师任课表的名称、数量、日期,检查签字栏与回执附件
教师任课表教师身份与可见范围匹配,同一记录的名称与日期无冲突用受限身份请求一次,比对返回字段与任课表原始记录
课后服务项目表项目名称、参与人数与日期在项目表与回执中一致,版本已同步核对项目表与回执的日期与人数,确认版本号与签字
请求头与请求体鉴权信息按外部系统要求传入,字段与外部接口约定一致在请求预览中核对 Authorization 取值来源,用样例请求比对 responseData 返回字段

容易做错的三处

  • 现象:同一学生在总课表与课后服务项目表中的姓名或日期对不上。原因:两份材料分别录入,未做同一记录的名称与日期比对。
  • 现象:教师任课表已修订,对外入口仍返回旧版本。原因:版本未同步,变更单未触发重新发布。
  • 现象:课后服务项目表缺少签字或回执。原因:项目确认单未回收,材料未闭环即进入对外服务。

怎么确认配好了

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

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

  • 在变量面板核对每个占位的来源,确认请求地址、路径参数、请求头与请求体中的变量可追溯到全局变量、系统变量或前方节点输出。
  • 用一条样例请求比对返回字段,检查总课表、教师任课表与课后服务项目表的名称、数量、日期、签字与回执是否一致。