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}
|