hl-api-changelog/changelogs/2026-04/13_1811_sync.md

API 变更通知

更新时间: 2026-04-13 18:12

⚠️ Breaking Changes (70)

前端必须处理的变更，不处理会导致功能异常

支付服务

接口删除

• ❌ POST /admin/product/item
• ❌ PUT /admin/product/item/{id}/basic

字段删除

数据对象	删除字段	原类型
GroupTourBatchDO	createBy	integer(int64)
管理端 - Step1 基础信息保存	balanceDueDays	integer(int32)
管理端 - Step1 基础信息保存	carouselImages	string[]
管理端 - Step1 基础信息保存	childAgeMax	integer(int32)
管理端 - Step1 基础信息保存	childAgeMin	integer(int32)
管理端 - Step1 基础信息保存	contactPhone	string
管理端 - Step1 基础信息保存	creatorAvatarUrl	string
管理端 - Step1 基础信息保存	creatorIntro	string
管理端 - Step1 基础信息保存	customerName	string
管理端 - Step1 基础信息保存	customizerId	integer(int64)
管理端 - Step1 基础信息保存	defaultDailyStock	integer(int32)
管理端 - Step1 基础信息保存	defaultRoomCount	integer(int32)
管理端 - Step1 基础信息保存	departureDate	string(date)
管理端 - Step1 基础信息保存	depositAmount	number
管理端 - Step1 基础信息保存	depositRatio	integer(int32)
管理端 - Step1 基础信息保存	diningHighlights	object[]
管理端 - Step1 基础信息保存	infantAgeMax	integer(int32)
管理端 - Step1 基础信息保存	infantDefaultPrice	number
管理端 - Step1 基础信息保存	isBooking	boolean
管理端 - Step1 基础信息保存	maxAdultPerOrder	integer(int32)
管理端 - Step1 基础信息保存	maxChildPerOrder	integer(int32)
管理端 - Step1 基础信息保存	mchId	string
管理端 - Step1 基础信息保存	minAdultPerOrder	integer(int32)
管理端 - Step1 基础信息保存	minGroupSize	integer(int32)
管理端 - Step1 基础信息保存	paymentType	string
管理端 - Step1 基础信息保存	photographyItems	object[]
管理端 - Step1 基础信息保存	safetyItems	object[]
管理端 - Step1 基础信息保存	seasons	string[]
管理端 - Step1 基础信息保存	showChatGroup	boolean
管理端 - Step1 基础信息保存	showReview	boolean
管理端 - Step1 基础信息保存	showTripDistance	boolean
管理端 - Step1 基础信息保存	showTripTime	boolean
管理端 - Step1 基础信息保存	toddlerAgeMax	integer(int32)
管理端 - Step1 基础信息保存	version	integer(int32)
管理端 - Step2 行程保存	version	integer(int32)
管理端 - Step3 路线与备品保存	routeName	string
管理端 - Step3 路线与备品保存	staffCostIds	integer[]
管理端 - Step3 路线与备品保存	vehicleModelId	integer(int64)
管理端 - Step3 路线与备品保存	version	integer(int32)
管理端 - Step5 补充信息保存	version	integer(int32)
管理端 - 产品列表项	createBy	integer(int64)
管理端 - 产品列表项	version	integer(int32)
管理端 - 产品详情	createBy	integer(int64)
管理端 - 产品详情	creatorAvatarUrl	string
管理端 - 产品详情	creatorIntro	string
管理端 - 产品详情	customerName	string
管理端 - 产品详情	customizerId	integer(int64)
管理端 - 产品详情	departureDate	string(date)
管理端 - 产品详情	mchId	string
管理端 - 产品详情	priceVersion	integer(int32)
管理端 - 产品详情	version	integer(int32)
管理端 - 价格日历批量设置	version	integer(int32)
管理端 - 产品线详情/列表项	createBy	integer(int64)
小程序端 - 产品详情	creatorAvatarUrl	string
小程序端 - 产品详情	creatorIntro	string

字段重命名

数据对象	原字段	新字段	类型
GroupTourBatchDO	createBy	createdBy	integer(int64)
管理端 - Step1 基础信息保存	contactPhone	category	string
管理端 - Step1 基础信息保存	creatorAvatarUrl	productType	string
管理端 - Step1 基础信息保存	customizerId	productId	integer(int64)
管理端 - 产品列表项	createBy	createdBy	integer(int64)
管理端 - 产品列表项	version	sortOrder	integer(int32)
管理端 - 产品详情	createBy	createdBy	integer(int64)
管理端 - 产品详情	creatorAvatarUrl	category	string
管理端 - 产品详情	priceVersion	currentStep	integer(int32)
管理端 - 产品线详情/列表项	createBy	createdBy	integer(int64)

字段类型变化

数据对象	字段	原类型	新类型
管理端 - Step1 基础信息保存	tiers	档位项[]	规格项[]
管理端 - 产品线详情/列表项	seasons	object	string[]
管理端 - 产品线详情/列表项	tags	object	string[]

ℹ️ 新增 (49)

支付服务

新增接口

• 🆕 POST /admin/product/item/basic

新增字段

数据对象	新增字段	类型
GroupBatchStaffDO	createdBy	integer(int64)
GroupBatchStaffDO	updatedBy	integer(int64)
GroupTourBatchDO	createdBy	integer(int64)
GroupTourBatchDO	updatedBy	integer(int64)
ProductCrowdBenefitDO	createdBy	integer(int64)
ProductCrowdBenefitDO	updatedBy	integer(int64)
ProductFeeItemDO	createdBy	integer(int64)
ProductFeeItemDO	updatedBy	integer(int64)
ProductPriceCalendarDO	createdBy	integer(int64)
ProductPriceCalendarDO	updatedBy	integer(int64)
ProductRouteInfoDO	createdBy	integer(int64)
ProductRouteInfoDO	updatedBy	integer(int64)
ProductSupplementDO	createdBy	integer(int64)
ProductSupplementDO	updatedBy	integer(int64)
ProductSuppliesDO	createdBy	integer(int64)
ProductSuppliesDO	updatedBy	integer(int64)
管理端 - Step1 基础信息保存	category	string
管理端 - Step1 基础信息保存	productId	integer(int64)
管理端 - Step1 基础信息保存	productType	string
管理端 - 产品列表项	category	string
管理端 - 产品列表项	createdBy	integer(int64)
管理端 - 产品列表项	createdByName	string
管理端 - 产品列表项	lineId	integer(int64)
管理端 - 产品列表项	lineName	string
管理端 - 产品列表项	seasons	string[]
管理端 - 产品列表项	sortOrder	integer(int32)
管理端 - 产品列表项	startPrice	number
管理端 - 产品列表项	subtitle	string
管理端 - 产品列表项	tags	string[]
管理端 - 产品列表项	tierCount	integer(int32)
管理端 - 产品列表项	tripNights	integer(int32)
管理端 - 产品详情	category	string
管理端 - 产品详情	createdBy	integer(int64)
管理端 - 产品详情	currentStep	integer(int32)
管理端 - 产品线详情/列表项	createdBy	integer(int64)
管理端 - 产品线详情/列表项	productCount	integer(int64)
ProductDayHotelDO	createdBy	integer(int64)
ProductDayHotelDO	updatedBy	integer(int64)
小程序端 - 产品列表项	lineName	string
小程序端 - 产品列表项	paymentType	string
小程序端 - 产品列表项	seasons	string[]
小程序端 - 产品列表项	sortOrder	integer(int32)
小程序端 - 产品列表项	startPrice	number
小程序端 - 产品列表项	startPriceLabel	string
小程序端 - 产品列表项	tags	string[]
小程序端 - 产品列表项	tierCount	integer(int32)
小程序端 - 产品列表项	tripNights	integer(int32)

字典变更

新增字典项

字典	新增值	标签
vehicle_type（车型）	GROUP	小蒙马专用