hl-api-changelog/changelogs-v2/2026-06/03_产品Step5服务标准tab-只读预览接口-管理后台.md

1.7 KiB

产品 Step5 服务标准 tab 只读预览接口

端类型:管理后台 日期2026-06-03 PR#3377

Step5 补充信息新增服务标准 tab,一个接口返三块都只读、实时拉取不冻快照当前绑定模板内容、各行程节点服务标准、各行程节点退费说明。模板的绑定走 Step5 保存的 serviceStandardTemplateId见另一篇《服务标准模板与产品关联说明》,本接口只负责只读预览。

接口

GET /admin/product/item/{id}/service-standard-previewadmin token,产品数据权限与产品详情同口径

返回 data

{
  templateId,                 // 当前绑定模板 ID,未绑定为 null
  template,                   // 绑定模板完整内容(id/name/intro/applicableScope/sections[].items[6字段]),未绑定为 null
  nodes: [                    // 行程节点的服务标准+退费说明,只含有内容的节点,皆空的节点不返回
    {
      dayNumber,
      nodeName,
      nodeType,               // SCENIC/ACTIVITY/HOTEL/RESTAURANT...
      serviceStandard,        // 节点服务标准,无则 null
      refundNote: { intro, items:[{title,amount,unitLabel,settleScope,settleScopeLabel,remark,effectiveFrom,effectiveTo}] }  // 无则 null
    }
  ]
}

测试服实测dev-v3

12 个产品调用全 200。模板块、退费说明块用真数据验证通过;节点服务标准块在景区/游玩项目/服务各配一条 service_standard 后,三类节点均正确返回。

前端动作

在服务标准 tab 调本接口渲染三块,均只读。serviceStandard/refundNote 可能为 null,按需隐藏。绑定写走 supplement 的 serviceStandardTemplateId,预览读走本接口。