feat: support shared FBA appointments and arrival calendar

2026-10-09 11:01:39 +08:00
parent 4f9433c39a
commit e94271706c
34 changed files with 677 additions and 121 deletions
@@ -0,0 +1,42 @@
+openapi: 3.0.3
+info:
+  title: 预约日历到港信息
+  version: 1.0.0
+security:
+  - bearerAuth: []
+paths:
+  /api/platform/v1/port-schedules/arrival-calendar:
+    get:
+      summary: 查询日期范围内货柜到港信息
+      description: '仅平台，权限platform:appointment:list。按有效柜次返回一条记录；实际到港优先取最新已观测实际船节点，其次柜次实际到港，再取预计到港。未提供日期的柜次不伪造日期。区间左闭右开，最多42天。'
+      parameters:
+        - {name: from, in: query, required: true, schema: {type: string, format: date}}
+        - {name: to, in: query, required: true, schema: {type: string, format: date}}
+      responses:
+        '200':
+          description: 业务响应，成功code为字符串200。
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  message: {type: string}
+                  data:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        containerBookingId: {type: string}
+                        bookingNo: {type: string}
+                        containerNo: {type: string, nullable: true}
+                        vesselName: {type: string, nullable: true}
+                        voyageNo: {type: string, nullable: true}
+                        destinationPortName: {type: string, nullable: true}
+                        destinationWarehouseCode: {type: string, nullable: true}
+                        arrivalAt: {type: string}
+                        arrivalType: {type: string, enum: [ACTUAL, ESTIMATED]}
+        '403': {description: 无权限或非平台身份}
+components:
+  securitySchemes:
+    bearerAuth: {type: http, scheme: bearer, bearerFormat: JWT}