166 行
8.9 KiB
Markdown
166 行
8.9 KiB
Markdown
# 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` | 小蒙马专用 |
|