Local API reference

The Print Bridge runs a small HTTP API bound to loopback: plain HTTP on 127.0.0.1:9110, and TLS on :9111 reachable from https://paperready.studio via local.paperready.studio (which resolves to 127.0.0.1 with a real certificate, so a secure page can talk to it). All endpoints are local — nothing is exposed to the internet.

GET /v1/health

Liveness + agent info (os, arch, version). Use it to detect whether the Bridge is running.

GET /v1/printers

The printers the OS knows about. Each has name, is_default, state, is_label_printer, and connection ("usb" | "network" | …).

POST /v1/print

Send a job to a printer. Body:

{
  "printer": "Zebra ZD421",
  "format": "document",        // "document" (PDF/PNG the OS renders) or "raw" (ZPL/EPL/TSPL)
  "data_base64": "<base64>",  // the label payload, base64-encoded
  "copies": 1
}

For raw, data_base64 is device commands sent byte-for-byte (e.g. ZPL). For document, it's a PDF or PNG the OS prints at true size.

Also available

GET /v1/jobs (recent jobs), POST /v1/jobs/:id/reprint, and the pairing endpoints (POST /v1/pair, GET /v1/pairing) used to link a machine to a workspace.