# Visualiza uma etiqueta

Retorna os detalhes de uma etiqueta específica.

Endpoint: GET /api/v3/labels/{labelId}
Version: 3.0.0
Security: OAuth2

## Header parameters:

  - `CPlug-Company-Id` (number, required)
    Id da Empresa (Company).

Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas.
    Example: 12

## Path parameters:

  - `labelId` (integer, required)
    ID da etiqueta.
    Example: 123

## Response 200 fields (application/json):

  - `data` (object)

  - `data.label` (object)
    Representa uma etiqueta de impressão completa

  - `data.label.id` (integer)
    Identificador único da etiqueta.
    Example: 123

  - `data.label.type` (string)
    Tipo da etiqueta.

- PDF: Etiqueta em formato PDF
- PPLA: Etiqueta em formato PPLA (Argox)
- BPLB: Etiqueta em formato BPLB (Elgin)
    Enum: "PDF", "PPLA", "BPLB"

  - `data.label.name` (string)
    Nome da etiqueta.
    Example: "Etiqueta Produtos"

  - `data.label.code` (string)
    Código identificador da etiqueta.
    Example: "ETQ001"

  - `data.label.backfeed` (integer)
    Valor de backfeed (para PPLA).
    Example: 203

  - `data.label.label_infos` (array)
    Informações da etiqueta (para tipos PPLA e BPLB).

  - `data.label.label_infos.id` (integer)
    Identificador único da informação da etiqueta.
    Example: 456

  - `data.label.label_infos.type` (string)
    Tipo da informação da etiqueta.

Há algumas restrições para os tipos de acordo com o tipo do modelo de etiqueta.

- PRODUCT_EXPIRATION_DATE: Apenas para PDF
- BARCODE: Apenas para PPLA e BPLB
- QRCODE: Apenas para PPLA
- LOGO: Apenas para PDF
    Enum: "COMPANY_NAME", "PRODUCT_CODE", "PRODUCT_NAME", "PRODUCT_CODE_NAME", "PRODUCT_CATEGORY", "PRODUCT_VALUE", "PRODUCT_EXPIRATION_DATE", "BARCODE", "QRCODE", "TEXT", "LOGO"

  - `data.label.label_infos.position` (integer)
    Posição/sequência da informação na etiqueta.
    Example: 1

  - `data.label.label_infos.font_family` (integer)
    Família da fonte (valores específicos por tipo).

- PPLA: 0-8
- BPLB: 1-5
    Example: 1

  - `data.label.label_infos.font_size` (integer)
    Tamanho da fonte (valores específicos por tipo).

- PPLA: 1-9
- BPLB: 1-8
    Example: 2

  - `data.label.label_infos.text_wrap_max` (integer)
    Máximo de caracteres por linha para quebra de texto.
    Example: 30

  - `data.label.label_infos.text_space` (integer)
    Espaçamento entre linhas.
    Example: 1

  - `data.label.label_infos.padding_bottom` (number)
    Padding inferior em milímetros.
    Example: 1

  - `data.label.label_infos.padding_left` (number)
    Padding esquerdo em milímetros.
    Example: 1

  - `data.label.label_infos.text` (string)
    Texto personalizado (obrigatório quando type=TEXT).
    Example: "Produto:"

  - `data.label.label_infos.qrcode_size` (number)
    Tamanho do QR Code em milímetros (usado quando type=QRCODE).
    Example: 10

  - `data.label.label_infos.reading_img_code` (string)
    Código de leitura para código de barras (obrigatório quando type=BARCODE).

Aqui há apenas alguns exemplos, para lista completa, consulte a tabela de códigos de barras da imagem.
    Enum: "C39", "C128", "EAN8", "EAN13"

  - `data.label.label_infos.wide_bar_width` (integer)
    Largura da barra larga do código de barras.
    Example: 5

  - `data.label.label_infos.fine_bar_width` (integer)
    Largura da barra fina do código de barras.
    Example: 2

  - `data.label.label_infos.height` (number)
    Altura do código de barras em milímetros.
    Example: 15

  - `data.label.label_infos.show_code` (boolean)
    Se deve exibir o código abaixo do código de barras.
    Example: true

  - `data.label.sheet` (object)
    Configurações da folha, colunas e linhas da etiqueta

  - `data.label.sheet.sheet_width` (number)
    Largura da folha em milímetros.
    Example: 210

  - `data.label.sheet.sheet_height` (number)
    Altura da folha em milímetros.
    Example: 297

  - `data.label.sheet.margin_left` (number)
    Margem esquerda da folha em milímetros.
    Example: 5

  - `data.label.sheet.margin_top` (number)
    Margem superior da folha em milímetros.
    Example: 5

  - `data.label.sheet.columns_amount` (integer)
    Quantidade de colunas na etiqueta.
    Example: 3

  - `data.label.sheet.columns_margin` (number)
    Espaçamento entre colunas em milímetros.
    Example: 2

  - `data.label.sheet.rows_amount` (integer)
    Quantidade de linhas na etiqueta.
    Example: 8

  - `data.label.sheet.rows_margin` (number)
    Espaçamento entre linhas em milímetros.
    Example: 2

  - `data.label.layout` (object)
    Configurações de layout, dimensões, padding e orientação da etiqueta

  - `data.label.layout.label_width` (number)
    Largura de uma etiqueta individual em milímetros.
    Example: 70

  - `data.label.layout.label_height` (number)
    Altura de uma etiqueta individual em milímetros.
    Example: 37

  - `data.label.layout.padding_top` (number)
    Padding superior da etiqueta em milímetros.
    Example: 1

  - `data.label.layout.padding_bottom` (number)
    Padding inferior da etiqueta em milímetros.
    Example: 1

  - `data.label.layout.padding_left` (number)
    Padding esquerdo da etiqueta em milímetros.
    Example: 1

  - `data.label.layout.padding_right` (number)
    Padding direito da etiqueta em milímetros.
    Example: 1

  - `data.label.layout.orientation` (string)
    Orientação da etiqueta.

- horizontal: Horizontal
- vertical: Vertical
    Enum: "horizontal", "vertical"

  - `data.label.font` (object)
    Configurações de fonte da etiqueta

  - `data.label.font.font_family` (string)
    Família da fonte.
    Enum: "Arial", "Times", "Courier"

  - `data.label.font.font_size` (integer)
    Tamanho da fonte.
    Example: 8

  - `data.label.font.text_align` (string)
    Alinhamento do texto.
    Enum: "left", "center", "right"

  - `data.label.barcode` (object)
    Configurações de código de barras e imagem de leitura da etiqueta

  - `data.label.barcode.reading_img_type` (string)
    Tipo de imagem de leitura.

- none: Nenhuma
- barcode: Código de barras
- qrcode: QR Code
    Enum: "none", "barcode", "qrcode"

  - `data.label.barcode.reading_img_code` (string)
    Código de leitura da imagem (obrigatório se reading_img_type não for 'none').

Aqui há apenas alguns exemplos, para lista completa, consulte a tabela de códigos de barras da imagem.
    Enum: "C39", "C128", "EAN8", "EAN13", "QRCODE"

## Response 400 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "missing_headers"

  - `message` (string)
    Descrição do erro.
    Example: "error message"

  - `meta` (array)
    Dados adicionais sobre o erro.


## Response 401 fields

## Response 404 fields