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

changelog: 2026-03/18_1555 (35 changes, 27 breaking)

浏览代码
这个提交包含在：
API Changelog Bot
2026-03-18 15:56:01 +08:00
父节点 f872743f7e
当前提交 1abe328fae
共修改 9 个文件，包含 5143 行新增和 2003 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
.swagger/hl-mp-service.json
+45 -229
查看文件
@@ -146,67 +146,6 @@
"x-order": "2147483647"
}
},
"/mp/product/batch/{batchId}/combos": {
"get": {
"tags": [
"C端 - 产品接口"
],
"summary": "GROUP批次套餐列表",
"description": "返回指定批次的所有套餐（名称、人数组合、价格、库存）",
"operationId": "listBatchCombosUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "batchId",
"in": "path",
"description": "批次ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
"originalRef": "统一响应结果«List«Map«string,object»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
"originalRef": "统一响应结果«List«Map«string,object»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/mp/product/lines": {
"get": {
"tags": [
@@ -264,7 +203,7 @@
"C端 - 产品接口"
],
"summary": "产品列表",
"description": "分页查询已上架产品，支持按关键词、产品类型(CORE/ROUTE/CUSTOM/GROUP)、季节、天数、目的地、产品线筛选和排序\n\n**关联字典（BFF透传）**：\n- product_type：产品类型（列表筛选+显示）\n- product_status：产品状态（透传自product-service）",
"description": "分页查询已上架产品，支持按关键词、产品类型(CORE/ROUTE/CUSTOM/GROUP)、季节、天数、目的地、产品线筛选和排序。\n\n**GROUP（小蒙马）产品额外返回 batches 字段**（可售团期列表，按出发日期升序），每个团期包含：\n- batchId：团期ID\n- departureDate：出发日期\n- batchLabel：团期标签（如\"五一团\"）\n- batchName：团期名称\n- batchStatus：团期状态\n- startingPrice：起步价(元)\n- enrolledCount：已报名人数\n- remainingSlots：剩余名额\n- isConfirmed：是否已成团\n\n**关联字典**：\n- product_type：产品类型（CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马）\n- batch_status：团期状态（ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已关闭）",
"operationId": "listProductsUsingGET",
"produces": [
"*/*"
@@ -402,7 +341,7 @@
"C端 - 产品接口"
],
"summary": "产品详情（聚合收藏状态）",
"description": "聚合流程：获取产品详情 → 并行查询收藏状态 → 异步记录足迹 → 返回聚合数据。支持未登录访问（不返回收藏状态）\n\n**关联字典（BFF透传）**：\n- product_type：产品类型（显示）\n- product_status：产品状态（透传自product-service）",
"description": "聚合流程：获取产品详情 → 并行查询收藏状态 → 异步记录足迹 → 返回聚合数据。支持未登录访问（不返回收藏状态）。\n\n**GROUP（小蒙马）产品额外返回 batches 字段**（可售团期列表），字段同产品列表。\n\n**关联字典**：\n- product_type：产品类型（CORE=核心产品, ROUTE=自驾路书, CUSTOM=私人定制, GROUP=小蒙马）\n- batch_status：团期状态（ENROLLING=报名中, CONFIRMED=已成团, FULL=已满员, CLOSED=已关闭）\n- product_status：产品状态（透传自product-service）",
"operationId": "getProductUsingGET",
"produces": [
"*/*"
@@ -457,137 +396,6 @@
"x-order": "2147483647"
}
},
"/mp/product/{productId}/batch-calendar": {
"get": {
"tags": [
"C端 - 产品接口"
],
"summary": "GROUP批次日历",
"description": "返回可报名批次列表（出发日期、剩余名额等），仅ENROLLING和CONFIRMED状态",
"operationId": "getBatchCalendarUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "productId",
"in": "path",
"description": "产品ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
"originalRef": "统一响应结果«List«Map«string,object»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«List«Map«string,object»»»",
"originalRef": "统一响应结果«List«Map«string,object»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/mp/product/{productId}/group-quote": {
"get": {
"tags": [
"C端 - 产品接口"
],
"summary": "GROUP报价",
"description": "返回指定批次的各套餐报价（totalSellPrice）",
"operationId": "getGroupQuoteUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "batchId",
"in": "query",
"description": "批次ID",
"required": false,
"type": "integer",
"format": "int64",
"allowEmptyValue": false
},
{
"name": "productId",
"in": "path",
"description": "产品ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Map«string,object»»",
"originalRef": "统一响应结果«Map«string,object»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Map«string,object»»",
"originalRef": "统一响应结果«Map«string,object»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/mp/product/{productId}/price-calendar": {
"get": {
"tags": [
@@ -9113,6 +8921,14 @@
"C端产品详情": {
"type": "object",
"properties": {
"batches": {
"type": "array",
"description": "可售期数列表（仅GROUP产品，按出发日期升序）",
"items": {
"$ref": "#/definitions/Map«string,object»",
"originalRef": "Map«string,object»"
}
},
"chatMessages": {
"type": "array",
"description": "群聊最近消息（来自会话存档）",
@@ -9180,20 +8996,6 @@
"type": "object"
}
},
"Map«string,object»_4": {
"type": "object",
"title": "Map«string,object»_4",
"additionalProperties": {
"type": "object"
}
},
"Map«string,object»_5": {
"type": "object",
"title": "Map«string,object»_5",
"additionalProperties": {
"type": "object"
}
},
"产品报价结果": {
"type": "object",
"properties": {
@@ -9415,27 +9217,6 @@
},
"title": "统一响应结果«List«Map«string,object»»»"
},
"统一响应结果«Map«string,object»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "object",
"description": "响应数据"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«Map«string,object»»"
},
"统一响应结果«产品报价结果»": {
"type": "object",
"properties": {
@@ -9558,6 +9339,20 @@
"originalRef": "List"
}
},
"Map«string,object»_4": {
"type": "object",
"title": "Map«string,object»_4",
"additionalProperties": {
"type": "object"
}
},
"Map«string,object»_5": {
"type": "object",
"title": "Map«string,object»_5",
"additionalProperties": {
"type": "object"
}
},
"修改订单请求": {
"type": "object",
"properties": {
@@ -9831,6 +9626,27 @@
},
"title": "统一响应结果«Map«string,List«Map«string,object»»»»"
},
"统一响应结果«Map«string,object»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "object",
"description": "响应数据"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«Map«string,object»»"
},
"统一响应结果«Void»": {
"type": "object",
"properties": {