# API 变更通知

**更新时间**: 2026-03-30 10:03

## ⚠️ Breaking Changes (4)

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

### 小程序聚合服务

**字段类型变化**

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

**参数删除**

- ❌ `GET /mp/trip/weather` 参数 ~~`city`~~
- ❌ `GET /mp/weather/forecast` 参数 ~~`city`~~
- ❌ `GET /mp/weather/live` 参数 ~~`city`~~

## ℹ️ 新增 (32)

### 小程序聚合服务

**新增接口**

- 🆕 `GET /mp/custom/detail`
- 🆕 `GET /mp/custom/list`
- 🆕 `GET /mp/custom/product/{productId}`
- 🆕 `GET /mp/custom/products`
- 🆕 `GET /mp/hotel/room-type/{roomTypeId}`
- 🆕 `GET /mp/order/{orderId}/transports`
- 🆕 `POST /mp/custom/submit`
- 🆕 `POST /mp/custom/{requestId}/cancel`
- 🆕 `POST /mp/order/refund/{orderId}/direct-appeal`
- 🆕 `POST /mp/order/{orderId}/transport`
- 🆕 `POST /mp/order/{orderId}/urge`
- 🆕 `PUT /mp/order/{orderId}/remark`

**新增字段**

| 数据对象 | 新增字段 | 类型 |
| --- | --- | --- |
| `C端产品详情` | `earlyBirdText` | `string` |
| `C端产品详情` | `refundPolicies` | `object` |
| `产品报价结果` | `available` | `boolean` |
| `产品报价结果` | `stock` | `integer(int32)` |
| `订单列表项` | `refundAmount` | `number` |
| `订单详情` | `displayStatus` | `string` |
| `订单详情` | `displayStatusLabel` | `string` |
| `订单详情` | `hotelAssignmentDetails` | `Map«string,object»[]` |
| `订单详情` | `refundPolicy` | `object` |
| `订单详情` | `sharerOpenid` | `string` |
| `订单详情` | `surchargeAmount` | `number` |
| `订单详情` | `surcharges` | `Map«string,object»[]` |
| `订单详情` | `transportSegments` | `Map«string,object»[]` |
| `退款申诉请求` | `appealAmount` | `number` |

**新增参数**

- `GET /mp/trip/weather` 新增参数 `latitude`
- `GET /mp/trip/weather` 新增参数 `longitude`
- `GET /mp/weather/forecast` 新增参数 `latitude`
- `GET /mp/weather/forecast` 新增参数 `longitude`
- `GET /mp/weather/live` 新增参数 `latitude`
- `GET /mp/weather/live` 新增参数 `longitude`
