闪电云印 logo 闪电云印

PRINT API · 自动下发 · 进度可查

让你的业务系统
直接调用打印机

通过一个统一接口提交 PDF、选择打印机并设置份数、单双面、纸型等参数。在线客户端接收任务后自动打印，业务系统可随时查询进度和结果。

查看 API 文档 开始接入
  • 标准 HTTP 接口
  • 服务端 Token 鉴权
  • 任务状态可追踪
POST /api/print/simple
curl -X POST \
  'https://api.sdwy520.com/api/print/simple' \
  -H 'X-Print-Api-Token: YOUR_TOKEN' \
  -F 'pdf=@order.pdf' \
  -F 'printer_key=YOUR_PRINTER_KEY' \
  -F 'copies=1' \
  -F 'paperSize=A4'
任务已创建status: pending

什么是打印 API

把“人工点打印”，变成系统自动执行。

打印 API 是连接你的业务系统与线下打印设备的程序接口。订单平台、门店系统、电商后台或自助终端可以在满足业务条件时自动创建打印任务，无需工作人员下载文件、打开文档、选择打印机再逐项设置。

它能解决什么问题

把重复操作交给接口，把时间留给业务。

01

减少人工操作

系统自动提交文件和打印参数，减少反复下载、打开和手动设置。

02

避免订单错配

通过 printer_key 指定目标打印机，让订单、文件和设备按规则对应。

03

连接分散设备

云端下发任务到在线客户端，不要求业务系统与打印机处于同一网络。

04

掌握任务结果

按 job_id 查询等待、打印中、完成或失败状态，方便页面展示与异常处理。

一次打印如何完成

五步接入，形成自动打印闭环。

  1. 1
    准备 Token

    在开发者中心创建服务端调用凭据。

  2. 2
    绑定打印机

    安装在线客户端并获取 printer_key。

  3. 3
    提交 PDF

    上传文件，并传入份数、纸型、颜色等参数。

  4. 4
    自动出件

    在线客户端接收任务并发送到本地打印机。

  5. 5
    查询结果

    业务系统通过 job_id 获取进度和最终状态。

统一接口，灵活控制

常用打印参数一次传入。

当前接口支持最大 50MB 的 PDF 文件，并可根据打印机能力设置常见选项。

查看完整参数与返回说明 →
copies
打印份数
pages
指定页码范围
orientation
横向或纵向
duplex
单面或双面
paperSize
A4、A3 等纸型
colorMode
黑白或彩色

适用场景

有订单，就可以触发打印。

订单平台

订单审核或付款完成后，自动打印随单文件与业务资料。

连锁门店

总部系统按门店和设备分发打印任务，减少人工传文件。

自助终端

用户完成选择与支付后，终端直接创建打印任务并展示进度。

SaaS 服务

为现有软件增加云打印能力，无需从头开发设备通信流程。

准备好开始了吗？

让第一张测试页，从接口开始打印。

注册并登录开发者中心，创建 Token、绑定打印机，即可在线调试真实打印任务。

进入开发者中心 阅读调用文档