wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

changelog: 2026-03/20_0908 (7 changes, 0 breaking)

浏览代码
这个提交包含在：
API Changelog Bot 2026-03-20 09:08:43 +08:00
父节点 597f580b01
当前提交 8c1c7ab7cc
共有 3 个文件被更改，包括 190 次插入 和 114 次删除
显示统计 下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

224
.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",

63
.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",

17
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`