文件
hl-api-changelog/changelogs/2026-04/0415-mp-detail-fields.md

2.5 KiB

小程序产品接口字段补全+bug修复

日期: 2026-04-15 服务: hl-product-service-v2 影响: 小程序端产品相关页面


1. MP产品详情 GET /mp/product/{id} — 新增字段

基础信息

字段 类型 说明
tags List<String> 产品标签,如["亲子","露营"]
seasons List<String> 产品季节,如["summer"]
lineId Long 产品线ID(面包屑导航用)
lineName String 产品线名称
tiers Array 档位列表(行程报价区块),如[{"tierSeq":1,"tierName":"舒适"}]
startPrice BigDecimal 起步价(未来可售最低成人售价)

路线概览

字段 类型 说明
totalMileage BigDecimal 总里程(km)
routeDescription String 路线描述文本

营销内容

字段 类型 说明
quickUnderstand Object 快速理解(JSON对象)
childExperience Object 孩子经历
growthGains Object 成长收获
yearReview Object 年度回顾视频
closing Object 写在最后

保障须知

字段 类型 说明
safetyItems Array 安全保障项(如[{"title":"保险","desc":"50万"}])
faqItems Array FAQ问答
bookingTermsContent String 预订条款内容(HTML)
warmTipsContent String 温馨提示内容(HTML)
insuranceNotice String 保险告知(INCLUDED/EXCLUDED/OPTIONAL)
equipmentAdvice String 装备建议(HTML)

行程天 itinerary[]. 新增

字段 类型 说明
photoUrls List<String> 行程天照片列表
hotels Array 每日住宿,[{"hotelName":"xxx","tierSeq":1}]

人群优惠 crowdBenefit. 新增

字段 类型 说明
elderAccommodation String 老人住宿(之前遗漏)

2. 产品对比接口变更

旧: GET /mp/product/compare?ids=1,2,3 新: POST /mp/product/compare?lineId={产品线ID}

传入产品线ID,自动返回该线下所有已上架产品的详情列表,无需前端知道具体产品ID。


3. Bug修复

  • 产品线列表过滤: GET /mp/product-line/list 现在只返回有上架产品的产品线(之前返回所有启用的线,包括空线)
  • 网关白名单: /mp/product/*/schedules 和 /mp/product/*/tier-compare 已加入JWT跳过列表,无需登录