36 lines
1.5 KiB
YAML
36 lines
1.5 KiB
YAML
|
openapi: 3.0.3
|
|||
|
|
info:
|
|||
|
|
title: Firstleg 客户统计 API
|
|||
|
|
version: 1.0.0
|
|||
|
|
paths:
|
|||
|
|
/api/platform/v1/customers/{customerId}/container-transit-summary:
|
|||
|
|
get:
|
|||
|
|
summary: 查询客户在途柜量（TEU）
|
|||
|
|
description: 需要 platform:firstleg:container:list；按客户+柜次去重，整柜按订舱客户归属，拼柜按 active LoadingPlanItem.accountId 归属。
|
|||
|
|
parameters:
|
|||
|
|
- {name: customerId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
|
|||
|
|
responses:
|
|||
|
|
'200':
|
|||
|
|
description: 成功或业务失败，响应体 code 为字符串 200 时成功
|
|||
|
|
content:
|
|||
|
|
application/json:
|
|||
|
|
schema: {$ref: '#/components/schemas/TransitSummaryEnvelope'}
|
|||
|
|
components:
|
|||
|
|
schemas:
|
|||
|
|
TransitSummaryEnvelope:
|
|||
|
|
type: object
|
|||
|
|
properties:
|
|||
|
|
code: {type: string, example: '200'}
|
|||
|
|
message: {type: string}
|
|||
|
|
data: {$ref: '#/components/schemas/TransitSummary'}
|
|||
|
|
TransitSummary:
|
|||
|
|
type: object
|
|||
|
|
required: [customerId, containerCount, totalTeu, unknownContainerCount, asOf, definition]
|
|||
|
|
properties:
|
|||
|
|
customerId: {type: integer, format: int64, minimum: 1}
|
|||
|
|
containerCount: {type: integer, format: int64, minimum: 0}
|
|||
|
|
totalTeu: {type: number, format: decimal, multipleOf: 0.01, minimum: 0, description: 已知箱型TEU合计；未知箱型不计入}
|
|||
|
|
unknownContainerCount: {type: integer, format: int64, minimum: 0}
|
|||
|
|
asOf: {type: string, format: date-time}
|
|||
|
|
definition: {type: string}
|