Guia Rápido de HTML para ZPL

Este serviço de API pode converter qualquer documento HTML em código ZPL compatível com impressoras de etiquetas Zebra. Ele executa folhas de estilo, carrega imagens e até executa JavaScript - assim como você está acostumado no seu navegador. A API HTML para ZPL é uma ótima maneira de criar templates personalizados para etiquetas Zebra sem precisar escrever ZPL você mesmo.

Uso da API

O método e endpoint da API é POST https://html-to-zpl.p.rapidapi.com/html2zpl

A chave da API fornecida pelo Rapid API deve ser configurada no cabeçalho HTTP X-RapidAPI-Key.

A chamada da API retorna dados ZPL brutos. Você pode salvá-los em um arquivo para processamento posterior ou enviá-los diretamente para uma impressora Zebra para imprimir a etiqueta.

Parâmetros

Os seguintes parâmetros podem ser configurados via o corpo de uma solicitação POST, seja como JSON (usando o content-type application/json) ou codificados em formulário (usando o cabeçalho content-type: application/x-www-form-urlencoded).

Nome do Parâmetro	Obrigatório	Descrição	Exemplo
height	sim	A altura da etiqueta em polegadas.	6
width	sim	A largura da etiqueta em polegadas.	4
html	sim	O conteúdo HTML que será renderizado na etiqueta. Você pode incluir imagens ou executar JavaScript. Recomendamos que você incorpore recursos externos como URLs de Dados, para evitar a necessidade de hospedar recursos.	<h1 font-size:40pt;margin-top:0.5in;>Hello World!<h1> <p style="margin-top:1.2in; font-size:25pt;">ZPL label generated by <u>htmltozpl.com</u></p>
dpi	não	A resolução da impressora Zebra em dpi (pontos por polegada): 203 (padrão) - 203 dpi / 8 dpmm - usado pela maioria das impressoras Zebra 300 - 300 dpi / 12 dpmm 600 - 600 dpi / 24 dpmm	203

Configurações de Qualidade de Impressão

Nome do Parâmetro	Obrigatório	Descrição	Exemplo
darkness	opcional	Um valor inteiro entre 0 e 30. Define a escuridão da impressora. Isto é equivalente a configurar a escuridão na configuração web ou driver da impressora Zebra.	15
dpi	opcional	A resolução da impressora Zebra em dpi (pontos por polegada): 203 (padrão) - 203 dpi / 8 dpmm - usado pela maioria das impressoras Zebra 300 - 300 dpi / 12 dpmm 600 - 600 dpi / 24 dpmm	203
speed	opcional	Um valor inteiro entre 2 e 12 que determina a velocidade do meio durante a impressão em polegadas por segundo. Isto é equivalente à configuração correspondente de taxa de impressão na configuração web ou driver da impressora Zebra.	2

dica

Reduzir a velocidade de impressão melhora a qualidade, especialmente para fontes pequenas e códigos de barras.

Exemplo usando a Linha de Comando

Abaixo está um breve exemplo que pode ser executado no CLI. Você precisará ter o curl instalado na sua máquina.

Para executar este exemplo, você precisará de uma Chave de API. Por favor, inscreva-se na API se ainda não tiver uma. Substitua API_KEY no exemplo pela sua chave.

Este comando gerará o código ZPL para uma etiqueta de 4" x 2" com algum texto de exemplo:

curl --request POST \
	--url https://html-to-zpl.p.rapidapi.com/html2zpl \
	--header 'content-type: application/json' \
	--header 'x-rapidapi-key: API_KEY' \
	--data '{ "width":"2", "height":"2", "html":"<div style=\"margin: 0.25in; border: 1px solid black;\">ZPL by htmltozpl.com</div>" }'

Após alguns segundos, a API enviará de volta os dados ZPL codificados:

^XA ^PW406^LL406^LS0 ^LH0,0 ^FO0,0^GFA,20706,20706,51, ,:::::::::::::::::::::::::::::::::::::::::::::::::R0G1iUFGES0R0G3iUFGES0:R0G3G8iT0G6S0R0G3G8W0G8hV0G6S0R0G3G8JFG3HFG8G0G7GFGEJ0G3GChV0G6S0R0G3G9JFG1IFG0G3GFGCJ0GFGChV0G6S0R0G3G9GCG0G1GEG0G7G8GFG8G0GFK0G3GChV0G6S0R0G3G9G8G0G3GCG0G7G8G3GCG0GFK0G3GChV0G6S0R0G3G9H0G7GCG0G7G8G1GEG0GFK0G3GChV0G6S0R0G3G9H0G7G8G0G7G8G1GEG0GFK0G3GChV0G6S0R0G3G8H0GFH0G7G8G1GEG0GFK0G3GChV0G6S0R0G3G8G0G1GFH0G7G8G1GEG0GFK0G3GCG7hU0G6S0R0G3G8G0G1GEH0G7G8G1GEG0GFK0G3GDGFGCG7GFG0G7GChO0G6S0R0G3G8G0G3GCH0G7G8G1GEG0GFK0G3HFGEG1GEG0G3G8hO0G6S0R0G3G8G0G7GCH0G7G8G3GCG0GFK0G3GEG1GEG0GEG0G3hP0G6S0R0G3G8G0G7G8H0G7GCGFG8G0GFK0G3GCG0GFG0GFG0G3hP0G6S0R0G3G8G0GFI0G7HFH0GFK0G3GCG0GFG0G7G0G6hP0G6S0R0G3G8G1GEI0G7G8I0GFK0G3GCG0G7G0G7G0G6hP0G6S0R0G3G8G3GEI0G7G8I0GFK0G3GCG0G7G0G3G8GChP0G6S0R0G3G8G3GCI0G7G8I0GFK0G3GCG0G7G0G3G8GChP0G6S0R0G3G8G7G8I0G7G8I0GFK0G3GCG0G7G0G1HChP0G6S0R0G3G8GFG8G0G1G8G7G8I0GFH0G1H0G3GCG0G7G0G1GDG8hP0G6S0R0G3G8GFH0G1G0G7G8I0GFH0G1H0G3GCG0G7G0G1GFG8hP0G6S0R0G3G9GEH0G1G0G7G8I0GFH0G3H0G3GCG0GEH0GFhQ0G6S0R0G3GBGEH0G3G0G7G8I0GFH0G6H0G3GCG0GCH0GFhQ0G6S0R0G3GBJFG0G7G8H0G1IFGEH0G1GEG1G8H0G7hQ0G6S0R0G3KFG3HFH0G7IFGEI0HFI0G6hQ0G6S0R0G3G8W0G3GCI0G6hQ0G6S0R0G3G8gH0GChQ0G6S0:R0G3G8gG0G1GChQ0G6S0R0G3G8g0G3GFG8hQ0G6S0R0G3G8g0G3GFhR0G6S0R0G3G8g0G3GEhR0G6S0R0G3G8gG0G8hR0G6S0R0G3G8iT0G6S0:R0G3G8G4R0G3V0G2hI0G6S0R0G3GBGER0GFV0GFhI0G6S0R0G3GFGEQ0G3GFU0G3GFhI0G6S0R0G3G9GER0G7V0GFhI0G6S0R0G3G9GEI0G2N0G7G0G1G8S0GFhI0G6S0R0G3G9GEI0G2N0G7G0G1G8S0G7hI0G6S0R0G3G9GEI0G6N0G7G0G3G8S0G7hI0G6S0R0G3G9GEI0GEN0G7G0G3G8S0G7hI0G6S0R0G3G9GEG3G8G1GFG0G1G8GFG0G7G8G0G7G0G7G8G0G1GEL0GCG7H0G7J0G7G8H0GFG8G0G1G8GEG0G7gM0G6S0R0G3G9GEGFGCG3GFGEG7G9GFG8GFGCG0G7G1HFG0G7GFG8G1IFG3GDGFGCG0G7I0G1GFGEG0G3GFGEG0G7G9GFG9GFGCgL0G6S0R0G3G9HFGEG0GEG0GFGBGFGDGFGEG0G7G0G7G8G0GCG3GCG1G8G1GEIFGEG0G7I0G3G8GFG0G7G0GFG1IFGBGFGCgL0G6S0R0G3G9GFG0GEG0GEG0G3GCG3GEG0GEG0G7G0G7G8G1G8G1GEG1G0G1GCG3GEG1GEG0G7I0G7G0G7G8GEG0G7G8G7GCG3GEG1GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G3G8G0GEG1G0G3GCG3GCG0GFG0G7I0G6G0G7G8GEG0G7G8G3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G3G8G0GFH0G7G8G1GCG0GFG0G7I0GEG0G3G1GEG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G7G8G0GFH0GFG0G1GCG0GFG0G7I0GEH0G1GEG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G7G8G0G7H0GEG0G1GCG0G7G0G7I0GEH0G1GCG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G7G8G0G7G0G1GEG0G1GCG0G7G0G7I0GEH0G1GEG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G7G8G0G7G0G3GCG0G1GCG0G7G0G7I0GEH0G1GEG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G7G8G0G7G0G7G8G0G1GCG0G7G0G7I0GFH0G9GEG0G3GCG3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GEG0G3G8G1GCG0GEG0G7G0G7G8G3G8G0G7G0G7G0H1GCG0G7G0G7I0GFG0G1G9GEG0G3G8G3G8G1GCG0GEgL0G6S0R0G3G9GEG0GEG0GFG0G3G8G1GCG0GEG0G7G0G7G8G3GCG0GEG0GFG0G3G1GCG0GEG0G7I0G7G8G1G0GFG0G3G8G3G8G1GCG0GEgL0G6S0R0G3G9GEG0GFG0GFG2G3G8G1GCG0GEG0G7G0G3G9G1GCG0GEG1GEG0G3G1GCG0GEG0GFG0G7G0G7GEG7G0GFG0G3G0G3G8G1GCG0GEgL0G6S0R0G3G9GEG0GFG0G7GEG3G8G1GCG0GFG0GFG0G3GFG0GEG1GCG3GCG0G7G1GEG1GCG0GFG0G7G8G3GFGEG0G7G8G6G0G7G8G1GCG0GEgL0G6S0R0G3HFGBGFGCG7GCGFGEG7GFGBGFG9GFGCG3GEG0G7GFG8G3IFG1HFG8G3GFGCG7G8G1GFGCG0G3GFGCG1GFGEHFG3GFG8gK0G6S0R0G3G8X0G1GCK0G1GDGEJ0G2H0G7I0G7gT0G6S0R0G3G8gK0G1GChM0G6S0::R0G3G8gK0G3GChM0G6S0:R0G3G8gK0HFhM0G6S0R0G3G8iT0G6S0R0G3iUFGES0:R0G1iUFGES0,::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::^FS^XZ

Este código ZPL pode ser enviado diretamente (bruto) para uma impressora Zebra para impressão. Se a impressora estiver conectada via rede, você pode enviar a string diretamente através de um socket TCP (porta padrão 9100) para a impressora. Por favor, verifique o FAQ para exemplos de código.

Para ver uma prévia do ZPL, você pode usar o visualizador no Labelary. Certifique-se de especificar o tamanho correto da etiqueta.