25 lines
1.2 KiB
YAML
25 lines
1.2 KiB
YAML
openapi: 3.0.3
|
||
info: { title: 公共费用目录内部查询, version: 1.0.0 }
|
||
security: [{ internalToken: [] }]
|
||
paths:
|
||
/internal/firstleg/v1/fee-items:
|
||
get:
|
||
summary: 查询当前启用的国际海外仓费用项目
|
||
parameters:
|
||
- { in: query, name: direction, schema: { type: string, enum: [RECEIVABLE, PAYABLE], default: RECEIVABLE } }
|
||
responses:
|
||
'200': { description: '统一响应data为费用项目数组，项目含code、name、defaultPrice；defaultPrice币种固定CNY，可为空。' }
|
||
'403': { description: 内部凭证缺失、错误或服务未配置凭证 }
|
||
/internal/firstleg/v1/fee-items/{code}:
|
||
get:
|
||
summary: 校验录费使用的当前费用项目资格
|
||
parameters:
|
||
- { in: path, name: code, required: true, schema: { type: string } }
|
||
- { in: query, name: direction, required: true, schema: { type: string, enum: [RECEIVABLE, PAYABLE] } }
|
||
responses:
|
||
'200': { description: 统一响应data为项目code、name、defaultPrice }
|
||
'409': { description: 项目不存在、停用或不适用于所选方向 }
|
||
components:
|
||
securitySchemes:
|
||
internalToken: { type: apiKey, in: header, name: X-Internal-Service-Token }
|