neodynamic/zplprinterwebapi

ZPLPrinter Web API Docker镜像

镜像概述

ZPLPrinter Web API Docker镜像提供了一个功能强大的虚拟ZPL打印机解决方案，能够将原始ZPL（Zebra编程语言）命令转换、预览并渲染为多种输出格式，包括PNG、JPG、PCX、GRF（ASCII Hex）和PDF。该镜像遵循REST原则设计，支持任何开发平台和编程语言（.NET、Java、PHP、Javascript、Python、Ruby等），通过简单的HTTP请求即可集成ZPL渲染功能。

作为虚拟ZPL打印机设备，该镜像能够解析和处理ZPL命令（原始或Base64字符串），生成高质量输出，精确还原内置和常驻ZPL字体的文本与条形码，并支持丰富的高级功能。

核心功能与特性

• 多格式输出：支持PNG、JPG、PCX、GRF（ASCII Hex）和PDF格式的渲染输出
• 跨平台兼容：可与任何开发平台和编程语言集成，无需特定SDK依赖
• REST API设计：通过HTTP POST请求实现交互，简化集成流程
• 虚拟ZPL打印机：模拟真实ZPL打印机设备，精确解析和处理ZPL命令
• 高质量渲染：高准确度还原ZPL内置和常驻字体，确保文本与条形码的精确呈现
• 国际化支持：兼容拉丁、亚洲及RTL（从右到左）语言文本
• 丰富的ZPL功能：支持大多数ZPL条形码、彩色色带模拟、自定义旋转角度等高级特性

!ZPL Commands Sample 1

!ZPL Commands Sample 2

!ZPL Commands Sample 3

!ZPL Commands Sample 4

使用场景

• 跨平台ZPL渲染：在无法直接访问物理ZPL打印机的环境中生成ZPL输出
• 应用集成：为Web、移动或桌面应用添加ZPL预览和打印功能
• 文档自动化：批量处理ZPL命令并生成存档用的PDF或图像文件
• 多语言支持需求：需要处理包含国际文本（如中文、日文、阿拉伯文）的ZPL标签
• 开发与测试：在开发阶段快速预览ZPL命令的实际输出效果

使用方法与配置说明

API交互流程

1. 发送HTTP POST请求至API端点，请求体包含ZPL打印任务的JSON对象
2. 指定输出格式：通过Accept请求头设置所需输出格式（如image/png、application/pdf等）
3. 接收渲染结果：API返回二进制形式的渲染输出，可直接保存为文件或在应用中显示

ZPL打印任务对象（JSON）

请求体需包含描述ZPL命令和打印机设置的JSON对象，主要字段包括：

• zpl：原始ZPL命令字符串（或Base64编码字符串）
• printerSettings：打印机配置，如分辨率（dpi）、标签尺寸等
• rotation：输出旋转角度（0、90、180、270度）
• colorRibbon：是否模拟彩色色带（布尔值）

请求示例（cURL）

bash
curl -X POST "http://localhost:5000/api/print" \
  -H "Content-Type: application/json" \
  -H "Accept: image/png" \
  -d '{
    "zpl": "^XA^FO50,50^A0N50,50^FDHello World^FS^FO50,150^B3N,,100,Y^FD123456^FS^XZ",
    "printerSettings": {
      "dpi": 203,
      "labelWidth": 4,
      "labelHeight": 6
    },
    "rotation": 0
  }' --output zpl-output.png

试用与资源

• 在线试用：[***]
• 帮助文档：主流编程语言示例代码及帮助主题

许可与支持

• 许可类型：商业产品，许可模式及价格详情见官方购买页面
• 技术支持：由Neodynamic开发团队提供技术支持服务