From 8c1c7ab7cc7ba4360cad2c383eebbb0721e26cfa Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 20 Mar 2026 09:08:43 +0800 Subject: [PATCH] changelog: 2026-03/20_0908 (7 changes, 0 breaking) --- .swagger/hl-contract-service.json | 224 ++++++++++++++--------------- .swagger/hl-order-service.json | 63 +++++++- changelogs/2026-03/20_0908_sync.md | 17 +++ 3 files changed, 190 insertions(+), 114 deletions(-) create mode 100644 changelogs/2026-03/20_0908_sync.md diff --git a/.swagger/hl-contract-service.json b/.swagger/hl-contract-service.json index 985987f..5583184 100644 --- a/.swagger/hl-contract-service.json +++ b/.swagger/hl-contract-service.json @@ -31,8 +31,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "401": { @@ -49,8 +49,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "401": { @@ -82,8 +82,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«旅行社信息»»", - "originalRef": "统一响应结果«List«旅行社信息»»" + "originalRef": "统一响应结果«List«旅行社信息»»", + "$ref": "#/definitions/统一响应结果«List«旅行社信息»»" } }, "401": { @@ -100,8 +100,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«旅行社信息»»", - "originalRef": "统一响应结果«List«旅行社信息»»" + "originalRef": "统一响应结果«List«旅行社信息»»", + "$ref": "#/definitions/统一响应结果«List«旅行社信息»»" } }, "401": { @@ -143,8 +143,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«合同信息»»", - "originalRef": "统一响应结果«List«合同信息»»" + "originalRef": "统一响应结果«List«合同信息»»", + "$ref": "#/definitions/统一响应结果«List«合同信息»»" } }, "401": { @@ -161,8 +161,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«合同信息»»", - "originalRef": "统一响应结果«List«合同信息»»" + "originalRef": "统一响应结果«List«合同信息»»", + "$ref": "#/definitions/统一响应结果«List«合同信息»»" } }, "401": { @@ -200,8 +200,8 @@ "description": "request", "required": true, "schema": { - "$ref": "#/definitions/补充约定模板请求", - "originalRef": "补充约定模板请求" + "originalRef": "补充约定模板请求", + "$ref": "#/definitions/补充约定模板请求" } } ], @@ -209,8 +209,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -230,8 +230,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -266,8 +266,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«补充约定模板»»", - "originalRef": "统一响应结果«List«补充约定模板»»" + "originalRef": "统一响应结果«List«补充约定模板»»", + "$ref": "#/definitions/统一响应结果«List«补充约定模板»»" } }, "401": { @@ -284,8 +284,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«补充约定模板»»", - "originalRef": "统一响应结果«List«补充约定模板»»" + "originalRef": "统一响应结果«List«补充约定模板»»", + "$ref": "#/definitions/统一响应结果«List«补充约定模板»»" } }, "401": { @@ -317,8 +317,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«补充约定模板»»", - "originalRef": "统一响应结果«List«补充约定模板»»" + "originalRef": "统一响应结果«List«补充约定模板»»", + "$ref": "#/definitions/统一响应结果«List«补充约定模板»»" } }, "401": { @@ -335,8 +335,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«补充约定模板»»", - "originalRef": "统一响应结果«List«补充约定模板»»" + "originalRef": "统一响应结果«List«补充约定模板»»", + "$ref": "#/definitions/统一响应结果«List«补充约定模板»»" } }, "401": { @@ -382,8 +382,8 @@ "description": "request", "required": true, "schema": { - "$ref": "#/definitions/补充约定模板请求", - "originalRef": "补充约定模板请求" + "originalRef": "补充约定模板请求", + "$ref": "#/definitions/补充约定模板请求" } } ], @@ -391,8 +391,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -412,8 +412,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -456,8 +456,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«Void»", - "originalRef": "统一响应结果«Void»" + "originalRef": "统一响应结果«Void»", + "$ref": "#/definitions/统一响应结果«Void»" } }, "204": { @@ -474,8 +474,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«Void»", - "originalRef": "统一响应结果«Void»" + "originalRef": "统一响应结果«Void»", + "$ref": "#/definitions/统一响应结果«Void»" } }, "204": { @@ -520,8 +520,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -541,8 +541,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«补充约定模板»", - "originalRef": "统一响应结果«补充约定模板»" + "originalRef": "统一响应结果«补充约定模板»", + "$ref": "#/definitions/统一响应结果«补充约定模板»" } }, "201": { @@ -583,8 +583,8 @@ "description": "创建合同请求", "required": false, "schema": { - "$ref": "#/definitions/创建合同请求", - "originalRef": "创建合同请求" + "originalRef": "创建合同请求", + "$ref": "#/definitions/创建合同请求" } } ], @@ -592,8 +592,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "201": { @@ -613,8 +613,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "201": { @@ -694,8 +694,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«分页结果«合同信息»»", - "originalRef": "统一响应结果«分页结果«合同信息»»" + "originalRef": "统一响应结果«分页结果«合同信息»»", + "$ref": "#/definitions/统一响应结果«分页结果«合同信息»»" } }, "401": { @@ -712,8 +712,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«分页结果«合同信息»»", - "originalRef": "统一响应结果«分页结果«合同信息»»" + "originalRef": "统一响应结果«分页结果«合同信息»»", + "$ref": "#/definitions/统一响应结果«分页结果«合同信息»»" } }, "401": { @@ -745,8 +745,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»", - "originalRef": "统一响应结果«List«ContractPlatformInfo»»" + "originalRef": "统一响应结果«List«ContractPlatformInfo»»", + "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»" } }, "401": { @@ -763,8 +763,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»", - "originalRef": "统一响应结果«List«ContractPlatformInfo»»" + "originalRef": "统一响应结果«List«ContractPlatformInfo»»", + "$ref": "#/definitions/统一响应结果«List«ContractPlatformInfo»»" } }, "401": { @@ -802,8 +802,8 @@ "description": "报备合同请求", "required": false, "schema": { - "$ref": "#/definitions/报备合同请求(同步模式)", - "originalRef": "报备合同请求(同步模式)" + "originalRef": "报备合同请求(同步模式)", + "$ref": "#/definitions/报备合同请求(同步模式)" } } ], @@ -811,8 +811,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "201": { @@ -832,8 +832,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "201": { @@ -868,8 +868,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«合同模板信息»»", - "originalRef": "统一响应结果«List«合同模板信息»»" + "originalRef": "统一响应结果«List«合同模板信息»»", + "$ref": "#/definitions/统一响应结果«List«合同模板信息»»" } }, "401": { @@ -886,8 +886,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«List«合同模板信息»»", - "originalRef": "统一响应结果«List«合同模板信息»»" + "originalRef": "统一响应结果«List«合同模板信息»»", + "$ref": "#/definitions/统一响应结果«List«合同模板信息»»" } }, "401": { @@ -929,8 +929,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "401": { @@ -947,8 +947,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同详情»", - "originalRef": "统一响应结果«合同详情»" + "originalRef": "统一响应结果«合同详情»", + "$ref": "#/definitions/统一响应结果«合同详情»" } }, "401": { @@ -993,8 +993,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "201": { @@ -1014,8 +1014,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "201": { @@ -1063,8 +1063,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«boolean»", - "originalRef": "统一响应结果«boolean»" + "originalRef": "统一响应结果«boolean»", + "$ref": "#/definitions/统一响应结果«boolean»" } }, "201": { @@ -1084,8 +1084,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«boolean»", - "originalRef": "统一响应结果«boolean»" + "originalRef": "统一响应结果«boolean»", + "$ref": "#/definitions/统一响应结果«boolean»" } }, "201": { @@ -1130,8 +1130,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "401": { @@ -1148,8 +1148,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "401": { @@ -1201,8 +1201,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "201": { @@ -1222,8 +1222,8 @@ "200": { "description": "OK", "schema": { - "$ref": "#/definitions/统一响应结果«合同信息»", - "originalRef": "统一响应结果«合同信息»" + "originalRef": "统一响应结果«合同信息»", + "$ref": "#/definitions/统一响应结果«合同信息»" } }, "201": { @@ -1279,8 +1279,8 @@ "type": "array", "description": "数据列表", "items": { - "$ref": "#/definitions/合同信息", - "originalRef": "合同信息" + "originalRef": "合同信息", + "$ref": "#/definitions/合同信息" } }, "total": { @@ -1474,8 +1474,8 @@ "type": "array", "description": "出行人列表", "items": { - "$ref": "#/definitions/合同出行人请求", - "originalRef": "合同出行人请求" + "originalRef": "合同出行人请求", + "$ref": "#/definitions/合同出行人请求" } }, "vehicleModel": { @@ -1830,8 +1830,8 @@ "type": "array", "description": "状态变更日志", "items": { - "$ref": "#/definitions/合同状态变更日志", - "originalRef": "合同状态变更日志" + "originalRef": "合同状态变更日志", + "$ref": "#/definitions/合同状态变更日志" } }, "supplementaryClause": { @@ -1863,8 +1863,8 @@ "type": "array", "description": "出行人列表", "items": { - "$ref": "#/definitions/合同出行人信息", - "originalRef": "合同出行人信息" + "originalRef": "合同出行人信息", + "$ref": "#/definitions/合同出行人信息" } } }, @@ -2052,8 +2052,8 @@ "type": "array", "description": "出行人列表", "items": { - "$ref": "#/definitions/合同出行人请求", - "originalRef": "合同出行人请求" + "originalRef": "合同出行人请求", + "$ref": "#/definitions/合同出行人请求" } } }, @@ -2127,8 +2127,8 @@ "type": "array", "description": "响应数据", "items": { - "$ref": "#/definitions/ContractPlatformInfo", - "originalRef": "ContractPlatformInfo" + "originalRef": "ContractPlatformInfo", + "$ref": "#/definitions/ContractPlatformInfo" } }, "message": { @@ -2152,8 +2152,8 @@ "type": "array", "description": "响应数据", "items": { - "$ref": "#/definitions/合同信息", - "originalRef": "合同信息" + "originalRef": "合同信息", + "$ref": "#/definitions/合同信息" } }, "message": { @@ -2177,8 +2177,8 @@ "type": "array", "description": "响应数据", "items": { - "$ref": "#/definitions/合同模板信息", - "originalRef": "合同模板信息" + "originalRef": "合同模板信息", + "$ref": "#/definitions/合同模板信息" } }, "message": { @@ -2202,8 +2202,8 @@ "type": "array", "description": "响应数据", "items": { - "$ref": "#/definitions/旅行社信息", - "originalRef": "旅行社信息" + "originalRef": "旅行社信息", + "$ref": "#/definitions/旅行社信息" } }, "message": { @@ -2227,8 +2227,8 @@ "type": "array", "description": "响应数据", "items": { - "$ref": "#/definitions/补充约定模板", - "originalRef": "补充约定模板" + "originalRef": "补充约定模板", + "$ref": "#/definitions/补充约定模板" } }, "message": { @@ -2288,8 +2288,8 @@ }, "data": { "description": "响应数据", - "$ref": "#/definitions/分页结果«合同信息»", - "originalRef": "分页结果«合同信息»" + "originalRef": "分页结果«合同信息»", + "$ref": "#/definitions/分页结果«合同信息»" }, "message": { "type": "string", @@ -2310,8 +2310,8 @@ }, "data": { "description": "响应数据", - "$ref": "#/definitions/合同信息", - "originalRef": "合同信息" + "originalRef": "合同信息", + "$ref": "#/definitions/合同信息" }, "message": { "type": "string", @@ -2332,8 +2332,8 @@ }, "data": { "description": "响应数据", - "$ref": "#/definitions/合同详情", - "originalRef": "合同详情" + "originalRef": "合同详情", + "$ref": "#/definitions/合同详情" }, "message": { "type": "string", @@ -2354,8 +2354,8 @@ }, "data": { "description": "响应数据", - "$ref": "#/definitions/补充约定模板", - "originalRef": "补充约定模板" + "originalRef": "补充约定模板", + "$ref": "#/definitions/补充约定模板" }, "message": { "type": "string", diff --git a/.swagger/hl-order-service.json b/.swagger/hl-order-service.json index e6f9377..33032a3 100644 --- a/.swagger/hl-order-service.json +++ b/.swagger/hl-order-service.json @@ -1221,6 +1221,58 @@ "*/*" ], "parameters": [ + { + "name": "contactPhone", + "in": "query", + "description": "联系电话", + "required": false, + "type": "string", + "x-example": "13800138000" + }, + { + "name": "createTimeEnd", + "in": "query", + "description": "下单时间结束(yyyy-MM-dd HH:mm:ss)", + "required": false, + "type": "string", + "format": "date-time", + "x-example": "2026-03-31 23:59:59" + }, + { + "name": "createTimeStart", + "in": "query", + "description": "下单时间起始(yyyy-MM-dd HH:mm:ss)", + "required": false, + "type": "string", + "format": "date-time", + "x-example": "2026-03-01 00:00:00" + }, + { + "name": "customizerName", + "in": "query", + "description": "定制师名称(模糊搜索)", + "required": false, + "type": "string", + "x-example": "王骁" + }, + { + "name": "departureDateEnd", + "in": "query", + "description": "出发日期结束(yyyy-MM-dd)", + "required": false, + "type": "string", + "format": "date", + "x-example": "2026-03-31" + }, + { + "name": "departureDateStart", + "in": "query", + "description": "出发日期起始(yyyy-MM-dd)", + "required": false, + "type": "string", + "format": "date", + "x-example": "2026-03-01" + }, { "name": "keyword", "in": "query", @@ -1229,6 +1281,14 @@ "type": "string", "x-example": "HL2026" }, + { + "name": "mchId", + "in": "query", + "description": "商户号(字典:mch_id)", + "required": false, + "type": "string", + "x-example": "shanhe" + }, { "name": "page", "in": "query", @@ -8708,7 +8768,6 @@ "出行人信息": { "type": "object", "required": [ - "birthday", "name" ], "properties": { @@ -8716,7 +8775,7 @@ "type": "string", "format": "date", "example": "1990-01-01", - "description": "出生日期(必填,后端根据此字段自动判断人员类型)" + "description": "出生日期(后端根据此字段自动判断人员类型,未传则默认ADULT)" }, "email": { "type": "string", diff --git a/changelogs/2026-03/20_0908_sync.md b/changelogs/2026-03/20_0908_sync.md new file mode 100644 index 0000000..f0e6f97 --- /dev/null +++ b/changelogs/2026-03/20_0908_sync.md @@ -0,0 +1,17 @@ +# API 变更通知 + +**更新时间**: 2026-03-20 09:09 + +## ℹ️ 新增 (7) + +### 订单服务 + +**新增参数** + +- `GET /admin/order/list` 新增参数 `contactPhone` +- `GET /admin/order/list` 新增参数 `createTimeEnd` +- `GET /admin/order/list` 新增参数 `createTimeStart` +- `GET /admin/order/list` 新增参数 `customizerName` +- `GET /admin/order/list` 新增参数 `departureDateEnd` +- `GET /admin/order/list` 新增参数 `departureDateStart` +- `GET /admin/order/list` 新增参数 `mchId`