概览
一次 REST 调用把打印任务发到任意实体打印机。创建 API Key、安装 Agent、五分钟内打出第一份 PDF。
PrintBase 文档
PrintBase 把你的应用和任何地方的实体打印机连起来：后端调用 REST API，打印机旁的轻量 Agent 经 WebSocket 接收任务并驱动硬件。无需内网穿透、不暴露打印机、状态实时回传。
Your App → PrintBase API → Agent → Printer五分钟打出第一份文件
1. 创建 API Key。 注册账号（免费套餐，无需绑卡），在控制台签发一个 Key，格式形如 pb_live_...。
2. 安装 Agent。 在能连到打印机的任意电脑上下载安装——Windows、macOS、Linux 均可。已安装的打印机会自动注册，每台分配一个数字 printer_code，在控制台或 GET /v1/printers 里可查。
3. 发送打印任务。
curl https://api.printbase.cloud/v1/print-jobs \
-H "Authorization: Bearer pb_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"printer_code": 1000000,
"content_type": "pdf",
"content_url": "https://example.com/hello.pdf"
}'响应会返回任务 id；通过 GET /v1/print-jobs/{id} 观察它沿 queued → dispatched → printing → completed 推进，或订阅 Webhook 接收推送。
content_type 支持 pdf（文档）和 raw（ZPL / ESC-POS 指令流，直通标签机和小票机）。内容可以内联 base64（content），也可以给一个由 Agent 下载的 URL（content_url）。
指南
- Get Started —— 完整的接入步骤
- Agent & WebSocket —— 任务分发与状态回传的原理