From 875d2497f49a82a62cdfe6311e59471c1d04de0f Mon Sep 17 00:00:00 2001
From: ouyangxq <775153912@qq.com>
Date: Tue, 29 Sep 2026 04:27:52 +0100
Subject: [PATCH] docs(firstleg): document price book channel query

---
 .../src/main/resources/openapi/sailing-calendar-v1.yaml     | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/firstleg/src/main/resources/openapi/sailing-calendar-v1.yaml b/firstleg/src/main/resources/openapi/sailing-calendar-v1.yaml
index 5f5cd274d..8cbbea00b 100644
--- a/firstleg/src/main/resources/openapi/sailing-calendar-v1.yaml
+++ b/firstleg/src/main/resources/openapi/sailing-calendar-v1.yaml
@@ -67,8 +67,12 @@ paths:
       responses: {'200': {description: ACTIVE 关联结果}}
   /api/platform/v1/sailing-channels:
     get:
-      summary: 查询船期渠道
+      summary: 查询当前生效船期价格表渠道
       x-permission: platform:firstleg:sailing-calendar:list
+      parameters:
+        - {name: keyword, in: query, schema: {type: string, maxLength: 64}}
+        - {name: status, in: query, schema: {type: string, enum: [ACTIVE, INACTIVE]}}
+        - {name: warehouseId, in: query, schema: {type: integer, format: int64, minimum: 1}, description: 按收货仓筛选有有效报价的渠道}
       responses: {'200': {description: OK}}
     post:
       summary: 新增船期渠道