# API 变更通知

**更新时间**: 2026-04-12 15:38

## ⚠️ Breaking Changes (10)

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

### 支付服务

**接口删除**

- ❌ ~~`GET /admin/payment/list`~~
- ❌ ~~`GET /admin/payment/merchants`~~
- ❌ ~~`GET /admin/payment/order/{orderId}`~~
- ❌ ~~`GET /admin/payment/refund/order/{orderId}`~~
- ❌ ~~`GET /admin/payment/refund/{refundId}`~~
- ❌ ~~`GET /admin/payment/{transactionId}`~~
- ❌ ~~`POST /admin/payment/{orderId}/refund`~~
- ❌ ~~`POST /admin/payment/{transactionId}/sync`~~

### 用户服务

**字段类型变化**

| 数据对象 | 字段 | 原类型 | 新类型 |
| --- | --- | --- | --- |
| `Traveler` | `gender` | `integer(int32)` | `string` |
| `出行人请求` | `gender` | `integer(int32)` | `string` |

## ℹ️ 新增 (99)

### 支付服务

**新增接口**

- 🆕 `DELETE /admin/product/item/{id}`
- 🆕 `DELETE /admin/product/item/{id}/itinerary/day/{dayNumber}`
- 🆕 `DELETE /admin/product/item/{id}/price-calendar`
- 🆕 `DELETE /admin/product/item/{id}/schedule/{scheduleId}`
- 🆕 `DELETE /admin/product/line/{id}`
- 🆕 `GET /admin/product/booking-terms/enabled`
- 🆕 `GET /admin/product/item/list`
- 🆕 `GET /admin/product/item/{id}`
- 🆕 `GET /admin/product/item/{id}/fee-deduction-preview`
- 🆕 `GET /admin/product/item/{id}/operation-logs`
- 🆕 `GET /admin/product/item/{id}/price-calendar`
- 🆕 `GET /admin/product/item/{id}/schedule/list`
- 🆕 `GET /admin/product/item/{id}/schedule/team`
- 🆕 `GET /admin/product/item/{id}/validate-publish`
- 🆕 `GET /admin/product/line/list`
- 🆕 `GET /admin/product/line/simple-list`
- 🆕 `GET /admin/product/line/{id}`
- 🆕 `GET /admin/product/safety-template/enabled`
- 🆕 `GET /admin/product/warm-tips/enabled`
- 🆕 `GET /mp/product-line/list`
- 🆕 `GET /mp/product-line/{lineId}/products`
- 🆕 `GET /mp/product/compare`
- 🆕 `GET /mp/product/{id}`
- 🆕 `GET /mp/product/{id}/price-calendar`
- 🆕 `GET /mp/product/{id}/schedules`
- 🆕 `GET /mp/product/{id}/tier-compare`
- 🆕 `POST /admin/product/item`
- 🆕 `POST /admin/product/item/{id}/action`
- 🆕 `POST /admin/product/item/{id}/copy`
- 🆕 `POST /admin/product/item/{id}/itinerary/day`
- 🆕 `POST /admin/product/item/{id}/price-calendar/batch`
- 🆕 `POST /admin/product/item/{id}/quote`
- 🆕 `POST /admin/product/item/{id}/schedule`
- 🆕 `POST /admin/product/item/{id}/schedule/batch-create`
- 🆕 `POST /admin/product/item/{id}/schedule/{scheduleId}/cancel`
- 🆕 `POST /admin/product/line`
- 🆕 `POST /mp/product/{id}/quote`
- 🆕 `PUT /admin/product/item/{id}/basic`
- 🆕 `PUT /admin/product/item/{id}/itinerary`
- 🆕 `PUT /admin/product/item/{id}/route`
- 🆕 `PUT /admin/product/item/{id}/schedule`
- 🆕 `PUT /admin/product/item/{id}/schedule/team`
- 🆕 `PUT /admin/product/item/{id}/supplement`
- 🆕 `PUT /admin/product/item/{id}/transfer`

### 用户服务

**新增字段**

| 数据对象 | 新增字段 | 类型 |
| --- | --- | --- |
| `字典数据项VO` | `remark` | `string` |
| `统一响应结果«Favorite»` | `success` | `boolean` |
| `统一响应结果«Footprint»` | `success` | `boolean` |
| `统一响应结果«List«Traveler»»` | `success` | `boolean` |
| `统一响应结果«List«字典VO»»` | `success` | `boolean` |
| `统一响应结果«Traveler»` | `success` | `boolean` |
| `统一响应结果«Void»` | `success` | `boolean` |
| `统一响应结果«boolean»` | `success` | `boolean` |
| `统一响应结果«分页结果«Favorite»»` | `success` | `boolean` |
| `统一响应结果«分页结果«Footprint»»` | `success` | `boolean` |
| `统一响应结果«用户信息VO»` | `success` | `boolean` |
| `统一响应结果«用户登录响应»` | `success` | `boolean` |
| `统一响应结果«AdminUser»` | `success` | `boolean` |
| `统一响应结果«List«旅行设计师VO»»` | `success` | `boolean` |
| `统一响应结果«Map«string,object»»` | `success` | `boolean` |
| `统一响应结果«分页结果«AdminUser»»` | `success` | `boolean` |
| `统一响应结果«Banner VO»` | `success` | `boolean` |
| `统一响应结果«分页结果«Banner VO»»` | `success` | `boolean` |
| `统一响应结果«分页结果«联系我们 VO»»` | `success` | `boolean` |
| `统一响应结果«联系我们 VO»` | `success` | `boolean` |
| `统一响应结果«分页结果«探索分类 VO»»` | `success` | `boolean` |
| `统一响应结果«探索分类详情 VO»` | `success` | `boolean` |
| `统一响应结果«List«string»»` | `success` | `boolean` |
| `统一响应结果«List«前端配置 VO»»` | `success` | `boolean` |
| `统一响应结果«分页结果«前端配置 VO»»` | `success` | `boolean` |
| `统一响应结果«前端配置 VO»` | `success` | `boolean` |
| `统一响应结果«List«常见问题分类VO»»` | `success` | `boolean` |
| `统一响应结果«List«常见问题条目VO»»` | `success` | `boolean` |
| `统一响应结果«常见问题分类VO»` | `success` | `boolean` |
| `统一响应结果«常见问题条目VO»` | `success` | `boolean` |
| `统一响应结果«分页结果«协议 VO»»` | `success` | `boolean` |
| `统一响应结果«协议 VO»` | `success` | `boolean` |
| `统一响应结果«管理员登录响应»` | `success` | `boolean` |
| `统一响应结果«List«SysRole»»` | `success` | `boolean` |
| `统一响应结果«SysRole»` | `success` | `boolean` |
| `统一响应结果«分页结果«SysRole»»` | `success` | `boolean` |
| `统一响应结果«List«SysMenu»»` | `success` | `boolean` |
| `统一响应结果«SysMenu»` | `success` | `boolean` |
| `统一响应结果«List«SysDictData»»` | `success` | `boolean` |
| `统一响应结果«SysDictData»` | `success` | `boolean` |
| `统一响应结果«SysDictType»` | `success` | `boolean` |
| `统一响应结果«分页结果«SysDictType»»` | `success` | `boolean` |
| `统一响应结果«分页结果«定时任务信息»»` | `success` | `boolean` |
| `统一响应结果«分页结果«定时任务执行日志»»` | `success` | `boolean` |
| `统一响应结果«定时任务信息»` | `success` | `boolean` |
| `统一响应结果«List«Map«string,object»»»` | `success` | `boolean` |
| `统一响应结果«List«WechatDepartment»»` | `success` | `boolean` |
| `统一响应结果«分页结果«WechatUser»»` | `success` | `boolean` |
| `统一响应结果«object»` | `success` | `boolean` |
| `统一响应结果«个人资料VO（角色感知）»` | `success` | `boolean` |
| `统一响应结果«分页结果«Map«string,object»»»` | `success` | `boolean` |
| `统一响应结果«定制师个人资料VO»` | `success` | `boolean` |
| `统一响应结果«定制师工作台VO（重构版）»` | `success` | `boolean` |
| `统一响应结果«分页结果«客户信息VO（管理端）»»` | `success` | `boolean` |
| `统一响应结果«客户信息VO（管理端）»` | `success` | `boolean` |