幼儿园卫生保健与膳食管理的授权访问与对外服务:HTTP 接口

围绕幼儿园卫生保健与膳食管理的授权访问与对外服务,说明HTTP 接口与外部系统的配置前提与核对动作,结合膳食食谱、食品留样记录确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

幼儿园卫生保健与膳食管理涉及食材名称与规格、留样时间与批次、消毒时段、缺勤病因归类四类材料。食材与规格来自采购与食谱,留样时间与批次来自厨房操作记录,消毒时段来自保育执行表,缺勤病因归类来自班级晨检。这些材料进入授权访问与对外服务时,食材与规格决定食谱可见范围,留样批次决定追溯单据的对外字段,消毒时段决定保育记录对上级开放的内容,缺勤病因归类决定对家长开放的粒度。更新节奏按日与按餐次推进,字段特征以时间、批次、时段、归类为主,需在对外入口保持与内部单据一致。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「可对外的入口与授权范围」由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体均可用变量占位,变量来自全局变量、系统变量或前方节点输出。

对象判断核验动作
食材名称与规格食谱与采购品类是否一致,规格能否对应到具体餐次在请求体里用 variables 引用前方节点输出的食材字段,预览渲染后比对采购单据
留样时间与批次单据与留样批次是否对得上,时间能否落到具体餐次在路径参数里引用留样批次变量,核对返回字段中的时间与批次是否与留样记录一致
消毒时段消毒记录是否缺时段,时段能否覆盖保育执行表在请求头传入 Authorization 后发起请求,核返回字段中的消毒时段是否完整
缺勤病因归类归类是否按约定粒度对外,受限身份是否越权可见用受限身份访问一次,核 responseData 中可见范围是否符合设定

容易做错的三处

  • 现象:对外单据与留样批次对不上,追溯时找不到对应餐次。原因:请求体里批次变量取自不同来源,未与留样记录对齐。
  • 现象:食谱与采购品类不一致,家长看到的食材与采购单不同。原因:食材名称与规格未按同一份来源渲染,变量占位解析成旧值。
  • 现象:消毒记录缺时段,上级查看时无法判断保育执行是否完整。原因:消毒时段字段未随请求体传入,返回字段为空。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果;确认路径参数、请求头与请求体中的 variables 均解析成实际值,Authorization 按外部系统要求传入,responseData 字段与约定一致,状态码为 200。

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

  • 在请求预览里看渲染后的完整地址,核对路径参数占位是否解析成实际值。
  • 在变量面板核对每个占位的来源,确认请求头名称与取值来源符合外部系统要求。