openapi: 3.0.3
info:
  title: Overseas pallet label
  version: 1.0.0
paths:
  /api/platform/v1/warehouse-admin/{warehouseId}/pallets/{id}/label:
    get:
      operationId: printOverseasPalletLabel
      summary: 下载指定托盘的一页标签 PDF
      description: 平台公共资源，要求 platform:overseas-warehouse:pallet:list。校验仓库和托盘归属后，有 FBA 仓码的托盘统一调用 Print FBA_PALLET_A4_LANDSCAPE_V1（297×210mm），顶部显示 SCK8 等 FBA 仓码，托盘完整编码同时作为 Code 128 内容和底部文字；内部编号如 141 原样保留。FBA 编码限 1–80 位可打印 ASCII，禁止首尾空格。不创建或修改托盘。其他托盘继续使用其现有 INBOUND_MARK_V1（100×100mm，编码限 1–34 位）。
      security:
        - bearerAuth: []
      parameters:
        - { name: warehouseId, in: path, required: true, schema: { type: integer, format: int64 } }
        - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
        - { name: X-Request-Id, in: header, required: false, schema: { type: string } }
      responses:
        '200':
          description: 成功返回单页 PDF；业务失败返回 JSON 信封（A0403、A0404、A0422 或 S0503）。
          content:
            application/pdf:
              schema: { type: string, format: binary }
            application/json:
              schema:
                type: object
                required: [code, message]
                properties:
                  code: { type: string }
                  message: { type: string }
                  requestId: { type: string }
        '401': { description: 未认证 }
        '403': { description: 权限不足 }
components:
  securitySchemes:
    bearerAuth: { type: http, scheme: bearer, bearerFormat: JWT }