Converter ZPL para PNG

Esta API rasteriza ZPL (Zebra Programming Language) em uma imagem PNG. Use-a para pré-visualizar etiquetas antes de imprimir, arquivar ZPL gerado como imagens ou mostrar uma etiqueta em um aplicativo web sem uma impressora na rede.

Usos típicos incluem QA das conversões de HTML/PDF, depuração de códigos de barras e layout, e guardar uma cópia visual de cada etiqueta impressa.

Experimente na demonstração online de ZPL para PNG.

Uso da API

Endpoint: POST https://html-to-zpl.p.rapidapi.com/zpl2png

Defina a chave da API do RapidAPI no cabeçalho X-RapidAPI-Key.

Envie os parâmetros no corpo do POST como JSON (Content-Type: application/json) ou como campos de formulário (Content-Type: application/x-www-form-urlencoded). A resposta é um PNG (Content-Type: image/png).

Em um servidor de API privado, a mesma requisição é POST http://SERVIDOR:8000/api/zpl2png.

Parâmetros obrigatórios

Parâmetro	Descrição	Exemplo
width	Largura da etiqueta, na unidade definida por unit (polegadas por padrão).	4
height	Altura da etiqueta, na unidade definida por unit (polegadas por padrão).	6
zpl	O código ZPL como texto UTF-8.	^XA^FO50,50^A0N,40,40^FDHello^FS^XZ

nota

ZPL quase sempre é texto simples, então envie no campo zpl. Se você já tiver o código em base64, pode enviar zplBase64 no lugar (sem prefixo de data-URL e sem quebras de linha).

Parâmetros opcionais

Parâmetro	Obrigatório	Descrição	Exemplo
rotate	opcional	Rotaciona o PNG. Um de 0 (padrão), 90 (direita), 180, 270 (esquerda).	90
unit	opcional	Unidade de width e height. Um de: in (padrão) — polegadas mm — milímetros dots — pontos da impressora	in

Faça width e height corresponderem à etiqueta para a qual o ZPL foi escrito. ^PW e ^LL no ZPL não substituem esses parâmetros.

O lado máximo da etiqueta é 15 polegadas. Pedidos no plano Developer (gratuito) incluem uma marca d'água; planos pagos e VMs privadas não.

Exemplo na linha de comando (curl)

Substitua API_KEY pela sua chave do RapidAPI.

JSON — uma etiqueta 4×2″:

curl --request POST \
	 --url https://html-to-zpl.p.rapidapi.com/zpl2png \
	 --header 'content-type: application/json' \
	 --header 'x-rapidapi-host: html-to-zpl.p.rapidapi.com' \
	 --header 'x-rapidapi-key: API_KEY' \
	 --data '{
	 	"width": 4,
	 	"height": 2,
	 	"zpl": "^XA^FO40,40^A0N,50,50^FDZPL to PNG^FS^FO40,120^A0N,30,30^FDhtmltozpl.com^FS^XZ"
	 }' \
	 --output label.png

A partir de um arquivo .zpl — zpl@arquivo lê o arquivo como o campo zpl:

wget https://www.htmltozpl.com/img/sample-label.zpl

curl --request POST \
	 --url https://html-to-zpl.p.rapidapi.com/zpl2png \
	 --header 'content-type: application/x-www-form-urlencoded' \
	 --header 'x-rapidapi-host: html-to-zpl.p.rapidapi.com' \
	 --header 'x-rapidapi-key: API_KEY' \
	 --data-urlencode 'width=4' \
	 --data-urlencode 'height=6' \
	 --data-urlencode '[email protected]' \
	 --output sample-label.png

Você pode baixar o ZPL 4×6″ de amostra usado acima.

Com rotação — gira o PNG 90° no sentido horário:

curl --request POST \
	 --url https://html-to-zpl.p.rapidapi.com/zpl2png \
	 --header 'content-type: application/json' \
	 --header 'x-rapidapi-host: html-to-zpl.p.rapidapi.com' \
	 --header 'x-rapidapi-key: API_KEY' \
	 --data '{
	 	"width": 4,
	 	"height": 6,
	 	"rotate": 90,
	 	"zpl": "^XA^FO50,50^A0N,40,40^FDHello^FS^XZ"
	 }' \
	 --output label-rotated.png

dica

As demonstrações de HTML para ZPL e PDF para ZPL já usam este endpoint para a pré-visualização na página. Depois de gerar ZPL, a imagem de pré-visualização é um PNG de /zpl2png.