API 接口与工具服务

通过 RESTful API 将灯盏打印能力无缝集成至您的业务系统，支持后台渲染、批量生成、PDF输出

核心API能力

模板渲染 API

传入模板ID与业务数据，后台自动渲染合并，返回高清PDF或PNG图片，无需前端介入，适合服务端批量生成场景。

POST /api/render/template

批量渲染 API

支持一次请求传入多条数据，后台并发渲染，返回压缩包或多页PDF，适合MES工单、电商标签批量生产。

POST /api/render/batch

模板管理 API

通过API创建、更新、查询、删除打印模板，实现模板的程序化管理，与您的业务系统模板库同步。

GET/POST /api/template

打印任务 API

创建打印任务并推送至指定网络打印机，支持打印状态回调，实现业务触发后的全自动静默打印。

POST /api/print/task

接入示例

// Node.js 示例 - 调用模板渲染API
const axios = require('axios');

const response = await axios.post('https://your-domain/api/render/template', {
  templateId: 'tpl_label_001',
  data: {
    productName: '蓝牙耳机 Pro',
    barcode: '6901234567890',
    price: '¥299',
    date: '2026-03-21'
  },
  format: 'pdf',   // 或 'png'
  dpi: 300
}, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});

// response.data.url => 渲染结果下载地址

支持 Java、Python、Node.js、PHP、Go 等主流语言 SDK

适用集成场景

MES系统集成

ERP单据打印

WMS仓储标签

电商批量图片

医疗条码打印

零售价格标签

物流快递面单

证件批量制作