开发者中心｜闪电云印

DEVELOPER CONSOLE

开发者中心信息

服务正常

闪电云印 API 面向第三方业务系统提供稳定的云打印能力，可快速接入电商订单、门店派货、消息通知等业务场景，将打印任务实时或定时下发至指定的本地打印机。开发者可通过统一接口完成自动化打印，并根据实际业务量灵活选择按次调用或包月套餐。

API 账户余额

--

冻结金额 ¥--

当前调用套餐 按次计费 每次调用 ¥0.05

购买包月后可不限量调用 API 打印。

如需开具发票，请联系 QQ：870477940

当前账户最多可申请 200 台打印机的 API Key。

API CREDENTIALS

API 接入凭据

打印端账号用于登录桌面客户端；Token 用于你的服务端调用 API。两者都只属于当前开发者账户。

打印端登录账号 --

仅用于 API 打印客户端，不能登录自助打印商户端。

服务端 API Token --

正在读取凭据状态…

PRINTERS

可用的打印机

No.	打印机名称	打印机别名	状态	API Key	操作

PRINT HISTORY

历史打印记录

仅展示当前开发者账户通过 API 提交的真实打印任务。

任务	打印机	参数	状态	费用	提交时间
正在读取历史记录…

ACCOUNT SETTINGS

个人中心

维护店铺资料与账号安全信息。

API REFERENCE

API 调用文档

面向门店系统、订单平台和自助终端的云打印接入指南。服务端提交 PDF 后，在线客户端会自动接收任务并发送到本地打印机。

服务地址https://api.sdwy520.com

01

QUICK START

五步完成一次打印

准备服务端 Token
获取 printer_key
上传 PDF 文件
提交打印任务
查询进度与结果

02

PRINT JOB

提交打印任务

POST/api/print/simplemultipart/form-data

参数	类型	必填	说明
`X-Print-Api-Token`	Header	是	开发者中心生成的服务端 Token
`pdf`	File	是	PDF 文件，最大 50MB
`printer_key`	String	是	目标打印机 API Key
`copies`	Integer	否	打印份数，默认 1
`orientation`	String	否	portrait 或 landscape
`duplex`	String	否	simplex、duplexlong、duplexshort
`pages`	String	否	页码范围，例如 1-3,5
`paperSize`	String	否	A4、A3、PHOTO_4X6
`colorMode`	String	否	bw 黑白或 color 彩色

03

PROGRESS

查询打印进度

GET/api/print/progress/{job_id}单个任务

GET/api/print/progress/batch?job_ids=101,102批量查询

状态包括 pending、printing、completed 和 failed，同时返回进度、页数与提示信息。

04

CLIENT DELIVERY

桌面客户端如何接单

建立连接

通过 wss://api.sdwy520.com/ws/device 建立 WebSocket。

下载文件

收到 print_job 后从可信 API 域名下载 PDF。

本地打印

映射打印机、单双面、页码、颜色和纸型。

回传结果

上报 print_progress 与 print_job_result。

05

ERRORS

常见错误

401: 服务端 Token 缺失或无效。
400: 缺少 PDF、printer_key 或参数格式不正确。
404: 打印机或任务不存在，请核对 Key 与 job_id。
500: 服务端处理失败，请记录 message 后联系技术支持。

cURL 请求示例

curl -X POST \
  'https://api.sdwy520.com/api/print/simple' \
  -H 'X-Print-Api-Token: YOUR_SERVER_TOKEN' \
  -F 'pdf=@document.pdf;type=application/pdf' \
  -F 'printer_key=YOUR_PRINTER_KEY' \
  -F 'copies=1' \
  -F 'orientation=portrait' \
  -F 'duplex=simplex' \
  -F 'paperSize=A4' \
  -F 'colorMode=bw'

成功响应

{
  "success": true,
  "message": "打印任务已创建",
  "data": {
    "job_id": 123,
    "printer_key": "YOUR_PRINTER_KEY",
    "printer_name": "前台打印机",
    "status": "pending",
    "delivery_status": "queued"
  }
}

接入支持

QQ / 微信：870477940

API CONSOLE

在线调试

填写打印参数并发送一份测试 PDF，快速验证打印机连接与任务下发是否正常。

服务端安全转发

在线调试与正式 API 使用相同的鉴权和计费规则。Token 仅用于本次 HTTPS 请求，不会保存在浏览器或本站数据库中。

01

鉴权、打印机与文件三项均为必填

API Token

打印机 API Key

测试 PDF 选择 PDF 文件仅支持 PDF，最大 50MB 浏览文件

02

打印参数未选择时使用推荐值

打印份数

纸张方向

双面打印

纸张规格

颜色模式

打印页码

我确认这会向所选打印机发送一个真实打印任务。

RESPONSE调用结果

等待发送测试任务

提交后，这里会显示 HTTP 状态、任务编号、投递状态和完整 JSON 响应。

PRINT CALLBACK返回响应

等待客户端返回

任务创建后将自动查询打印进度，并显示打印中、完成或失败结果。

SUPPORT

问题反馈

如果您在使用闪电云印过程中遇到问题，请填写下面的信息。我们会尽快查看并与您联系。

QQ 870477940

微信 870477940

开发者中心

开发者中心信息

API 接入凭据

可用的打印机

历史打印记录

个人中心

店铺信息

修改密码

API 调用文档

五步完成一次打印

提交打印任务

查询打印进度

桌面客户端如何接单

常见错误

在线调试

问题反馈