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}
                        cabinetNo: {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}