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 }