这个品类的数据长什么样
幼儿园游戏活动组织在授权访问与对外服务上,材料分三类:观察记录与区域计划、材料投放清单、活动目标与反思转下周计划。这些材料来自班级日常保教现场,按周更新,字段带班级、区域、活动名称、观察要点、材料名称与数量、目标达成描述、反思条目与下周计划调整。进入 HTTP 接口与外部系统这一功能时,观察记录与区域计划作为可见范围判定依据,决定家长或上级能读到哪些内容;材料投放清单作为请求体字段,供外部系统核对数量;活动目标与反思转下周计划作为返回字段被后续节点解析,用于更新对外展示。三类材料共同支撑授权访问与对外服务,越权内容不可见。
配置怎么定
这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「可对外的入口与授权范围」由后续节点解析响应,或外部系统按约定处理接着完成。HTTP 节点向目标地址发请求,路径参数、请求体与请求头三处都能用变量占位,变量来自全局变量、系统变量或前方节点输出。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 观察记录与区域计划 | 观察记录与区域计划对应,授权访问时受限身份只能看到本班本区域内容,越权条目不出现在返回字段 | 在请求预览里看渲染后的完整地址,核对路径参数与请求头取值来源,确认返回字段只含本班本区域 |
| 材料投放清单 | 材料投放数量与活动目标达成所需一致,请求体字段与外部接口约定相符,不出现空字段 | 用一条样例请求比对返回,核对请求体字段与材料投放数量,检查 variables 占位是否解析成实际值 |
| 活动目标与反思转下周计划 | 目标与观察相符,反思转下周计划已更新,返回字段中的目标达成描述与计划条目能对上 | 在变量面板核对每个占位来源,检查 responseData 返回字段与 Authorization 请求头取值,确认计划条目已更新 |
容易做错的三处
- 现象:外部系统收到空字段。原因:请求体里材料投放数量占位未解析,或变量来源未指向前方节点输出,导致字段缺失。
- 现象:目标与观察不符。原因:活动目标未随观察记录同步调整,返回字段中的达成描述仍按旧目标生成,对外展示不一致。
- 现象:计划未更新。原因:反思转下周计划条目停留在上一周,材料不足时也未补充投放清单,后续节点解析到过期内容。
怎么确认配好了
本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 variables 占位解析、Authorization 请求头传入、responseData 返回字段与约定一致。
业务测试:用受限身份访问一次,看可见范围是否符合设定,越权条目不可见。
- 在请求预览里看渲染后的完整地址,核对路径参数、请求头名称与取值来源,确认
Authorization按外部系统要求传入。 - 在变量面板核对每个占位来源,用一条样例请求比对返回,检查请求体字段与材料投放数量、活动目标、反思转下周计划是否一致。