docs(firstleg): document price book channel query

2026-09-29 04:27:52 +01:00
parent ed36c43af4
commit 875d2497f4
1 changed files with 5 additions and 1 deletions
@@ -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: 新增船期渠道